Monitorowanie zadań usługi Stream Analytics i zarządzanie nimi za pomocą poleceń cmdlet programu Azure PowerShell

  • Artykuł

Dowiedz się, jak monitorować zasoby usługi Stream Analytics i zarządzać nimi za pomocą poleceń cmdlet programu Azure PowerShell i skryptów programu PowerShell, które wykonują podstawowe zadania usługi Stream Analytics.

Uwaga

Do interakcji z platformą Azure zalecamy używanie modułu Azure Az w programie PowerShell. Zobacz Instalowanie programu Azure PowerShell, aby rozpocząć. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Wymagania wstępne dotyczące uruchamiania poleceń cmdlet programu Azure PowerShell dla usługi Stream Analytics

Azure PowerShell 0.9.8:

# Log in to your Azure account
Add-AzureAccount
# Select the Azure subscription you want to use to create the resource group if you have more han one subscription on your account.
Select-AzureSubscription -SubscriptionName <subscription name>
# If Stream Analytics has not been registered to the subscription, remove remark symbol below (#)to run the Register-AzureProvider cmdlet to register the provider namespace.
#Register-AzureProvider -Force -ProviderNamespace 'Microsoft.StreamAnalytics'
# Create an Azure resource group
New-AzureResourceGroup -Name <YOUR RESOURCE GROUP NAME> -Location <LOCATION>

Azure PowerShell 1.0:

# Log in to your Azure account
Connect-AzAccount
# Select the Azure subscription you want to use to create the resource group.
Get-AzSubscription -SubscriptionName "your sub" | Select-AzSubscription
# If Stream Analytics has not been registered to the subscription, remove remark symbol below (#)to run the Register-AzureProvider cmdlet to register the provider namespace.
#Register-AzResourceProvider -Force -ProviderNamespace 'Microsoft.StreamAnalytics'
# Create an Azure resource group
New-AzResourceGroup -Name <YOUR RESOURCE GROUP NAME> -Location <LOCATION>

Uwaga

Zadania usługi Stream Analytics utworzone programowo nie mają domyślnie włączonego monitorowania. Możesz ręcznie włączyć monitorowanie w witrynie Azure Portal, przechodząc do strony Monitorowanie zadania i klikając przycisk Włącz. Możesz to zrobić programowo, wykonując kroki znajdujące się w usłudze Azure Stream Analytics — Programowe monitorowanie zadań usługi Stream Analytics.

Polecenia cmdlet programu Azure PowerShell dla usługi Stream Analytics

Następujące polecenia cmdlet programu Azure PowerShell mogą służyć do monitorowania zadań usługi Azure Stream Analytics i zarządzania nimi. Pamiętaj, że program Azure PowerShell ma różne wersje. W przykładach wymienionych pierwsze polecenie dotyczy programu Azure PowerShell 0.9.8, drugie polecenie dotyczy programu Azure PowerShell 1.0. Polecenia programu Azure PowerShell 1.0 zawsze będą miały wartość "Az".

Get-AzureStreamAnalyticsJob | Get-AzStreamAnalyticsJob

Wyświetla listę wszystkich zadań usługi Stream Analytics zdefiniowanych w subskrypcji platformy Azure lub określonej grupie zasobów lub pobiera informacje o zadaniu o określonym zadaniu w grupie zasobów.

Przykład 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsJob

To polecenie programu PowerShell zwraca informacje o wszystkich zadaniach usługi Stream Analytics w subskrypcji platformy Azure.

Przykład 2

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US

Azure PowerShell 1.0:

Get-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US

To polecenie programu PowerShell zwraca informacje o wszystkich zadaniach usługi Stream Analytics w grupie zasobów StreamAnalytics-Default-Central-US.

Przykład 3

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

To polecenie programu PowerShell zwraca informacje o zadaniu usługi Stream Analytics StreamingJob w grupie zasobów StreamAnalytics-Default-Central-US.

Get-AzureStreamAnalyticsInput | Get-AzStreamAnalyticsInput

Wyświetla listę wszystkich danych wejściowych zdefiniowanych w określonym zadaniu usługi Stream Analytics lub pobiera informacje o określonych danych wejściowych.

Przykład 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

To polecenie programu PowerShell zwraca informacje o wszystkich danych wejściowych zdefiniowanych w zadaniu StreamingJob.

Przykład 2

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

Azure PowerShell 1.0:

Get-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

To polecenie programu PowerShell zwraca informacje o danych wejściowych o nazwie EntryStream zdefiniowanych w zadaniu StreamingJob.

Get-AzureStreamAnalyticsOutput | Get-AzStreamAnalyticsOutput

Wyświetla listę wszystkich danych wyjściowych zdefiniowanych w określonym zadaniu usługi Stream Analytics lub pobiera informacje o określonych danych wyjściowych.

Przykład 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob

To polecenie programu PowerShell zwraca informacje o danych wyjściowych zdefiniowanych w zadaniu StreamingJob.

Przykład 2

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Azure PowerShell 1.0:

Get-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

To polecenie programu PowerShell zwraca informacje o danych wyjściowych o nazwie Output zdefiniowanych w zadaniu StreamingJob.

Get-AzureStreamAnalyticsQuota | Get-AzStreamAnalyticsQuota

Pobiera informacje o limitach przydziału jednostek przesyłania strumieniowego w określonym regionie.

Przykład 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsQuota -Location "Central US"

Azure PowerShell 1.0:

Get-AzStreamAnalyticsQuota -Location "Central US"

To polecenie programu PowerShell zwraca informacje o limitach przydziału i użyciu jednostek przesyłania strumieniowego w regionie Środkowe stany USA.

Get-AzureStreamAnalyticsTransformation | Get-AzStreamAnalyticsTransformation

Pobiera informacje o określonej transformacji zdefiniowanej w zadaniu usługi Stream Analytics.

Przykład 1

Azure PowerShell 0.9.8:

Get-AzureStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name StreamingJob

Azure PowerShell 1.0:

Get-AzStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name StreamingJob

To polecenie programu PowerShell zwraca informacje o transformacji o nazwie StreamingJob w zadaniu StreamingJob.

New-AzureStreamAnalyticsInput | New-AzStreamAnalyticsInput

Tworzy nowe dane wejściowe w zadaniu usługi Stream Analytics lub aktualizuje istniejące określone dane wejściowe.

Nazwę danych wejściowych można określić w pliku .json lub w wierszu polecenia. Jeśli oba są określone, nazwa w wierszu polecenia musi być taka sama jak nazwa w pliku.

Jeśli określisz dane wejściowe, które już istnieją i nie określisz parametru -Force, polecenie cmdlet zapyta, czy zastąpić istniejące dane wejściowe.

Jeśli określisz parametr -Force i określisz istniejącą nazwę wejściową, dane wejściowe zostaną zastąpione bez potwierdzenia.

Aby uzyskać szczegółowe informacje na temat struktury i zawartości pliku JSON, zapoznaj się z sekcją Tworzenie danych wejściowych (Azure Stream Analytics) w bibliotece referencyjnej interfejsu API REST zarządzania usługą Stream Analytics.

Przykład 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json"

Azure PowerShell 1.0:

New-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json"

To polecenie programu PowerShell tworzy nowe dane wejściowe z pliku Input.json. Jeśli istniejące dane wejściowe o nazwie określonej w pliku definicji wejściowej są już zdefiniowane, polecenie cmdlet wyświetli pytanie, czy go zastąpić.

Przykład 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream

Azure PowerShell 1.0:

New-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream

To polecenie programu PowerShell tworzy nowe dane wejściowe w zadaniu o nazwie EntryStream. Jeśli istniejące dane wejściowe o tej nazwie są już zdefiniowane, polecenie cmdlet wyświetli pytanie, czy go zastąpić.

Przykład 3

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -File "C:\Input.json" -Name EntryStream -Force

To polecenie programu PowerShell zastępuje definicję istniejącego źródła wejściowego o nazwie EntryStream definicją z pliku.

New-AzureStreamAnalyticsJob | New-AzStreamAnalyticsJob

Tworzy nowe zadanie usługi Stream Analytics na platformie Microsoft Azure lub aktualizuje definicję istniejącego określonego zadania.

Nazwę zadania można określić w pliku .json lub w wierszu polecenia. Jeśli oba są określone, nazwa w wierszu polecenia musi być taka sama jak nazwa w pliku.

Jeśli określisz nazwę zadania, które już istnieje i nie określisz parametru -Force, polecenie cmdlet wyświetli pytanie, czy zastąpić istniejące zadanie.

Jeśli określisz parametr -Force i określisz istniejącą nazwę zadania, definicja zadania zostanie zastąpiona bez potwierdzenia.

Aby uzyskać szczegółowe informacje na temat struktury i zawartości pliku JSON, zapoznaj się z sekcją Tworzenie zadania usługi Stream Analytics w bibliotece referencyjnej interfejsu API REST zarządzania usługą Stream Analytics.

Przykład 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json"

Azure PowerShell 1.0:

New-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json"

To polecenie programu PowerShell tworzy nowe zadanie z definicji w JobDefinition.json. Jeśli istniejące zadanie o nazwie określonej w pliku definicji zadania jest już zdefiniowane, polecenie cmdlet wyświetli pytanie, czy go zastąpić.

Przykład 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json" -Name StreamingJob -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\JobDefinition.json" -Name StreamingJob -Force

To polecenie programu PowerShell zastępuje definicję zadania streamingJob.

New-AzureStreamAnalyticsOutput | New-AzStreamAnalyticsOutput

Tworzy nowe dane wyjściowe w zadaniu usługi Stream Analytics lub aktualizuje istniejące dane wyjściowe.

Nazwę danych wyjściowych można określić w pliku .json lub w wierszu polecenia. Jeśli oba są określone, nazwa w wierszu polecenia musi być taka sama jak nazwa w pliku.

Jeśli określisz dane wyjściowe, które już istnieją i nie określisz parametru -Force, polecenie cmdlet wyświetli pytanie, czy zastąpić istniejące dane wyjściowe.

Jeśli określisz parametr -Force i określisz istniejącą nazwę danych wyjściowych, dane wyjściowe zostaną zastąpione bez potwierdzenia.

Aby uzyskać szczegółowe informacje na temat struktury i zawartości pliku JSON, zapoznaj się z sekcją Tworzenie danych wyjściowych (Azure Stream Analytics) w bibliotece referencyjnej interfejsu API REST zarządzania usługą Stream Analytics.

Przykład 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output

Azure PowerShell 1.0:

New-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output

To polecenie programu PowerShell tworzy nowe dane wyjściowe o nazwie "output" w zadaniu StreamingJob. Jeśli istniejące dane wyjściowe o tej nazwie są już zdefiniowane, polecenie cmdlet zapyta, czy go zastąpić.

Przykład 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Output.json" -JobName StreamingJob -Name output -Force

To polecenie programu PowerShell zastępuje definicję parametru "output" w zadaniu StreamingJob.

New-AzureStreamAnalyticsTransformation | New-AzStreamAnalyticsTransformation

Tworzy nową transformację w zadaniu usługi Stream Analytics lub aktualizuje istniejącą transformację.

Nazwę przekształcenia można określić w pliku .json lub w wierszu polecenia. Jeśli oba są określone, nazwa w wierszu polecenia musi być taka sama jak nazwa w pliku.

Jeśli określisz przekształcenie, które już istnieje i nie określisz parametru -Force, polecenie cmdlet wyświetli pytanie, czy zastąpić istniejące przekształcenie.

Jeśli określisz parametr -Force i określisz istniejącą nazwę przekształcenia, przekształcenie zostanie zastąpione bez potwierdzenia.

Aby uzyskać szczegółowe informacje na temat struktury i zawartości pliku JSON, zapoznaj się z sekcją Create Transformation (Azure Stream Analytics) w bibliotece referencyjnej interfejsu API REST zarządzania usługą Stream Analytics.

Przykład 1

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform

Azure PowerShell 1.0:

New-AzStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform

To polecenie programu PowerShell tworzy nową transformację o nazwie StreamingJobTransform w zadaniu StreamingJob. Jeśli istniejąca transformacja jest już zdefiniowana przy użyciu tej nazwy, polecenie cmdlet wyświetli pytanie, czy go zastąpić.

Przykład 2

Azure PowerShell 0.9.8:

New-AzureStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform -Force

Azure PowerShell 1.0:

New-AzStreamAnalyticsTransformation -ResourceGroupName StreamAnalytics-Default-Central-US -File "C:\Transformation.json" -JobName StreamingJob -Name StreamingJobTransform -Force

To polecenie programu PowerShell zastępuje definicję Elementu StreamingJobTransform w zadaniu StreamingJob.

Remove-AzureStreamAnalyticsInput | Remove-AzStreamAnalyticsInput

Asynchronicznie usuwa określone dane wejściowe z zadania usługi Stream Analytics na platformie Microsoft Azure.
Jeśli określisz parametr -Force, dane wejściowe zostaną usunięte bez potwierdzenia.

Przykład 1

Azure PowerShell 0.9.8:

Remove-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EventStream

Azure PowerShell 1.0:

Remove-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EventStream

To polecenie programu PowerShell usuwa wejściowy element EventStream w zadaniu StreamingJob.

Remove-AzureStreamAnalyticsJob | Remove-AzStreamAnalyticsJob

Asynchronicznie usuwa określone zadanie usługi Stream Analytics na platformie Microsoft Azure.
Jeśli określisz parametr -Force, zadanie zostanie usunięte bez potwierdzenia.

Przykład 1

Azure PowerShell 0.9.8:

Remove-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

Azure PowerShell 1.0:

Remove-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

To polecenie programu PowerShell usuwa zadanie StreamingJob.

Remove-AzureStreamAnalyticsOutput | Remove-AzStreamAnalyticsOutput

Asynchronicznie usuwa określone dane wyjściowe z zadania usługi Stream Analytics na platformie Microsoft Azure.
Jeśli określisz parametr -Force, dane wyjściowe zostaną usunięte bez potwierdzenia.

Przykład 1

Azure PowerShell 0.9.8:

Remove-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Azure PowerShell 1.0:

Remove-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

To polecenie programu PowerShell usuwa dane wyjściowe w zadaniu StreamingJob.

Start-AzureStreamAnalyticsJob | Start-AzStreamAnalyticsJob

Asynchronicznie wdraża i uruchamia zadanie usługi Stream Analytics na platformie Microsoft Azure.

Przykład 1

Azure PowerShell 0.9.8:

Start-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob -OutputStartMode CustomTime -OutputStartTime 2012-12-12T12:12:12Z

Azure PowerShell 1.0:

Start-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob -OutputStartMode CustomTime -OutputStartTime 2012-12-12T12:12:12Z

To polecenie programu PowerShell uruchamia zadanie StreamingJob z niestandardowym czasem rozpoczęcia danych wyjściowych ustawionym na 12 grudnia 2012, 12:12:12 UTC.

Stop-AzureStreamAnalyticsJob | Stop-AzStreamAnalyticsJob

Asynchronicznie uniemożliwia uruchamianie zadania usługi Stream Analytics na platformie Microsoft Azure i cofa przydzielanie zasobów, które były używane. Definicja i metadane zadania pozostaną dostępne w ramach subskrypcji zarówno za pośrednictwem witryny Azure Portal, jak i interfejsów API zarządzania, tak aby można było edytować i ponownie uruchomić zadanie. Opłaty za zadanie nie będą naliczane w stanie zatrzymanym.

Przykład 1

Azure PowerShell 0.9.8:

Stop-AzureStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

Azure PowerShell 1.0:

Stop-AzStreamAnalyticsJob -ResourceGroupName StreamAnalytics-Default-Central-US -Name StreamingJob

To polecenie programu PowerShell zatrzymuje zadanie StreamingJob.

Test-AzureStreamAnalyticsInput | Test-AzStreamAnalyticsInput

Testuje zdolność usługi Stream Analytics do nawiązywania połączenia z określonymi danymi wejściowymi.

Przykład 1

Azure PowerShell 0.9.8:

Test-AzureStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

Azure PowerShell 1.0:

Test-AzStreamAnalyticsInput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name EntryStream

To polecenie programu PowerShell sprawdza stan połączenia wejściowego elementu EntryStream w obiekcie StreamingJob.

Test-AzureStreamAnalyticsOutput | Test-AzStreamAnalyticsOutput

Testuje możliwość połączenia usługi Stream Analytics z określonymi danymi wyjściowymi.

Przykład 1

Azure PowerShell 0.9.8:

Test-AzureStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

Azure PowerShell 1.0:

Test-AzStreamAnalyticsOutput -ResourceGroupName StreamAnalytics-Default-Central-US -JobName StreamingJob -Name Output

To polecenie programu PowerShell sprawdza stan połączenia danych wyjściowych w obiekcie StreamingJob.

Uzyskiwanie pomocy technicznej

Aby uzyskać dalszą pomoc, wypróbuj stronę pytań i odpowiedzi firmy Microsoft dotyczącą usługi Azure Stream Analytics.

Następne kroki