Monitorowanie zadań usługi Stream Analytics i zarządzanie nimi za pomocą poleceń cmdlet programu Azure PowerShell
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. Aby rozpocząć, zobacz Instalowanie programu Azure PowerShell. 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
- Utwórz grupę zasobów platformy Azure w ramach subskrypcji. Poniżej przedstawiono przykładowy skrypt programu Azure PowerShell. Aby uzyskać informacje o programie Azure PowerShell, zobacz Instalowanie i konfigurowanie programu Azure PowerShell;
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
- Wprowadzenie do usługi Azure Stream Analytics
- Get started using Azure Stream Analytics (Rozpoczynanie pracy z usługą Azure Stream Analytics)
- Scale Azure Stream Analytics jobs (Skalowanie zadań usługi Azure Stream Analytics)
- Azure Stream Analytics Query Language Reference (Dokumentacja dotycząca języka zapytań usługi Azure Stream Analytics)
- Azure Stream Analytics Management REST API Reference (Dokumentacja interfejsu API REST zarządzania usługą Azure Stream Analytics)