Compartilhar via

az stream-analytics job

Note

Essa referência faz parte da extensão de análise de fluxo para a CLI do Azure (versão 2.75.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de de trabalho de análise de fluxo. Saiba mais sobre extensões.

Gerenciar o trabalho de streaming com análise de fluxo.

Comandos

Nome Description Tipo Status
az stream-analytics job create

Crie um trabalho de streaming ou substitua um trabalho de streaming já existente.

 Extension GA
az stream-analytics job delete

Exclua um trabalho de streaming.

 Extension GA
az stream-analytics job list

Liste todos os trabalhos de streaming no grupo de recursos especificado. E lista todos os trabalhos de streaming na assinatura fornecida.

 Extension GA
az stream-analytics job scale

Dimensione um trabalho de streaming quando o trabalho estiver em execução.

 Extension GA
az stream-analytics job show

Obtenha detalhes sobre o trabalho de streaming especificado.

 Extension GA
az stream-analytics job start

Inicie um trabalho de streaming. Depois que um trabalho for iniciado, ele começará a processar eventos de entrada e produzirá a saída.

 Extension GA
az stream-analytics job stop

Pare um trabalho de streaming em execução. Isso fará com que um trabalho de streaming em execução pare de processar eventos de entrada e produzir saída.

 Extension GA
az stream-analytics job update

Atualize um trabalho de streaming existente. Isso pode ser usado para atualizar parcialmente (ou seja, atualizar uma ou duas propriedades) um trabalho de streaming sem afetar o restante da definição do trabalho.

 Extension GA
az stream-analytics job wait

Coloque a CLI em um estado de espera até que uma condição do trabalho de análise de fluxo seja atendida.

 Extension GA

az stream-analytics job create

Crie um trabalho de streaming ou substitua um trabalho de streaming já existente.

az stream-analytics job create --job-name --name
                               --resource-group
                               [--arrival-max-delay]
                               [--compatibility-level {1.0, 1.2}]
                               [--content-storage-policy {JobStorageAccount, SystemAccount}]
                               [--data-locale]
                               [--functions]
                               [--id]
                               [--identity]
                               [--if-match]
                               [--if-none-match]
                               [--inputs]
                               [--job-storage-account]
                               [--job-type {Cloud, Edge}]
                               [--location]
                               [--no-wait]
                               [--order-max-delay]
                               [--out-of-order-policy {Adjust, Drop}]
                               [--output-error-policy {Drop, Stop}]
                               [--output-start-mode {CustomTime, JobStartTime, LastOutputEventTime}]
                               [--output-start-time]
                               [--outputs]
                               [--tags]
                               [--transformation]

Exemplos

Criar um trabalho de streaming completo (um trabalho de streaming com uma transformação, pelo menos 1 entrada e pelo menos 1 saída)

az stream-analytics job create --job-name "sj7804" --resource-group "sjrg3276" --location "West US" --compatibility-level "1.0" --data-locale "en-US" --arrival-max-delay 5 --order-max-delay 0 --out-of-order-policy "Drop" --functions "[]" --inputs "[{\"name\":\"inputtest\",\"properties\":{\"type\":\"Stream\",\"datasource\":{\"type\":\"Microsoft.Storage/Blob\",\"properties\":{\"container\":\"containerName\",\"pathPattern\":\"\",\"storageAccounts\":[{\"accountKey\":\"yourAccountKey==\",\"accountName\":\"yourAccountName\"}]}},\"serialization\":{\"type\":\"Json\",\"properties\":{\"encoding\":\"UTF8\"}}}}]" --output-error-policy "Drop" --outputs "[{\"name\":\"outputtest\",\"datasource\":{\"type\":\"Microsoft.Sql/Server/Database\",\"properties\":{\"database\":\"databaseName\",\"password\":\"userPassword\",\"server\":\"serverName\",\"table\":\"tableName\",\"user\":\"<user>\"}}}]" --transformation name="transformationtest" streaming-units=1 query="Select Id, Name from inputtest" --tags key1="value1" key3="value3" randomKey="randomValue"

Criar um shell de trabalho de streaming (um trabalho de streaming sem entradas, saídas, transformação ou funções)

az stream-analytics job create --job-name "sj59" --resource-group "sjrg6936" --location "West US" --compatibility-level "1.0" --data-locale "en-US" --arrival-max-delay 16 --order-max-delay 5 --out-of-order-policy "Drop" --functions "[]" --inputs "[]" --output-error-policy "Drop" --outputs "[]" --tags key1="value1" key3="value3" randomKey="randomValue"

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--arrival-max-delay

O atraso tolerável máximo em segundos em que os eventos que chegam tarde podem ser incluídos. O intervalo com suporte é -1 para 1814399 (20,23:59:59 dias) e -1 é usado para especificar a espera indefinidamente. Se a propriedade estiver ausente, ela será interpretada para ter um valor de -1.

--compatibility-level

Controla determinados comportamentos de runtime do trabalho de streaming.

Propriedade Valor
Valores aceitos: 1.0, 1.2
--content-storage-policy

Os valores válidos são JobStorageAccount e SystemAccount. Se definido como JobStorageAccount, isso requer que o usuário também especifique a propriedade jobStorageAccount. .

Propriedade Valor
Valores aceitos: JobStorageAccount, SystemAccount
--data-locale

A localidade de dados do trabalho de análise de fluxo. O valor deve ser o nome de uma cultura .NET com suporte do conjunto https://msdn.microsoft.com/en-us/library/system.globalization.culturetypes(v=vs.110).aspx. O padrão é 'en-US' se nenhum especificado.

--functions

Uma lista de uma ou mais funções para o trabalho de streaming. A propriedade de nome para cada função é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a transformação individual. Valor esperado: json-string/json-file/@json-file.

--id

A ID do recurso do cluster.

Propriedade Valor
Grupo de parâmetros: Cluster Arguments
--identity

Descreva a identidade gerenciada atribuída pelo sistema atribuída a esse trabalho que pode ser usada para autenticar com entradas e saídas.

Uso: --identity tenant-id=XX principal-id=XX type=XX

tenant-id: The identity tenantId principal-id: The identity principal ID type: The identity type.

--if-match

A ETag do trabalho de streaming. Omita esse valor para sempre substituir o conjunto de registros atual. Especifique o valor de ETag visto pela última vez para impedir a substituição acidental de alterações simultâneas.

--if-none-match

Defina como '*' para permitir que um novo trabalho de streaming seja criado, mas para impedir a atualização de um conjunto de registros existente. Outros valores resultarão em uma resposta com falha de pré-condição 412.

--inputs

Uma lista de uma ou mais entradas para o trabalho de streaming. A propriedade de nome para cada entrada é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a entrada individual. Valor esperado: json-string/json-file/@json-file.

--job-storage-account

As propriedades associadas a uma conta de Armazenamento do Azure com MSI.

Uso: --job-storage-account authentication-mode=XX account-name=XX account-key=XX

modo de autenticação: modo de autenticação. nome da conta: o nome da conta de Armazenamento do Azure. Obrigatório em solicitações PUT (CreateOrReplace). chave de conta: a chave da conta para a conta de Armazenamento do Azure. Obrigatório em solicitações PUT (CreateOrReplace).

--job-type

Descreve o tipo do trabalho. Os modos válidos são Cloud e 'Edge'.

Propriedade Valor
Valores aceitos: Cloud, Edge
--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--order-max-delay

O atraso tolerável máximo em segundos em que os eventos fora de ordem podem ser ajustados para estarem de volta em ordem.

--out-of-order-policy

Indica a política a ser aplicada a eventos que chegam fora de ordem no fluxo de eventos de entrada.

Propriedade Valor
Valores aceitos: Adjust, Drop
--output-error-policy

Indica a política a ser aplicada a eventos que chegam à saída e não podem ser gravados no armazenamento externo devido à má formação (valores de coluna ausentes, valores de coluna de tipo ou tamanho incorretos).

Propriedade Valor
Valores aceitos: Drop, Stop
--output-start-mode

Essa propriedade só deve ser utilizada quando desejar que o trabalho seja iniciado imediatamente após a criação. O valor pode ser JobStartTime, CustomTime ou LastOutputEventTime para indicar se o ponto inicial do fluxo de eventos de saída deve ser iniciado sempre que o trabalho for iniciado, iniciar em um carimbo de data/hora do usuário personalizado especificado por meio da propriedade outputStartTime ou iniciar a partir da hora de saída do último evento.

Propriedade Valor
Valores aceitos: CustomTime, JobStartTime, LastOutputEventTime
--output-start-time

O valor é um carimbo de data/hora formatado ISO-8601 que indica o ponto inicial do fluxo de eventos de saída ou nulo para indicar que o fluxo de eventos de saída será iniciado sempre que o trabalho de streaming for iniciado. Essa propriedade deve ter um valor se outputStartMode estiver definido como CustomTime.

--outputs

Uma lista de uma ou mais saídas para o trabalho de streaming. A propriedade de nome para cada saída é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a saída individual. Valor esperado: json-string/json-file/@json-file.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--transformation

Indique a consulta e o número de unidades de streaming a serem usadas para o trabalho de streaming. A propriedade de nome da transformação é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a transformação individual.

Uso: --transformation streaming-units=XX valid-streaming-units=XX query=XX name=XX

unidades de streaming: especifica o número de unidades de streaming que o trabalho de streaming usa. valid-streaming-units: especifica as unidades de streaming válidas para as quais um trabalho de streaming pode ser dimensionado. consulta: especifica a consulta que será executada no trabalho de streaming. Saiba mais sobre a SAQL (Linguagem de Consulta do Stream Analytics) aqui: https://msdn.microsoft.com/library/azure/dn834998 . Obrigatório em solicitações PUT (CreateOrReplace). nome: Nome do recurso.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job delete

Exclua um trabalho de streaming.

az stream-analytics job delete --job-name --name
                               --resource-group
                               [--no-wait]
                               [--yes]

Exemplos

Excluir um trabalho de streaming

az stream-analytics job delete --job-name "sj59" --resource-group "sjrg6936"

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job list

Liste todos os trabalhos de streaming no grupo de recursos especificado. E lista todos os trabalhos de streaming na assinatura fornecida.

az stream-analytics job list [--expand]
                             [--resource-group]

Exemplos

Listar todos os trabalhos de streaming em um grupo de recursos e não usar o parâmetro de consulta OData $expand

az stream-analytics job list --resource-group "sjrg6936"

Listar todos os trabalhos de streaming em um grupo de recursos e usar o parâmetro de consulta $expand OData para expandir entradas, saídas, transformação e funções

az stream-analytics job list --expand "inputs,outputs,transformation,functions" --resource-group "sjrg3276"

Listar todos os trabalhos de streaming em uma assinatura e não usar o parâmetro de consulta $expand OData

az stream-analytics job list

Listar todos os trabalhos de streaming em uma assinatura e usar o parâmetro de consulta $expand OData para expandir entradas, saídas, transformação e funções

az stream-analytics job list --expand "inputs,outputs,transformation,functions"

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--expand

O parâmetro de consulta OData $expand. Esta é uma lista separada por vírgulas de propriedades de trabalho de streaming adicionais a serem incluídas na resposta, além do conjunto padrão retornado quando esse parâmetro está ausente. O conjunto padrão é todas as propriedades de trabalho de streaming que não sejam 'entradas', 'transformação', 'saídas' e 'funções'.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job scale

Dimensione um trabalho de streaming quando o trabalho estiver em execução.

az stream-analytics job scale --job-name --name
                              --resource-group
                              [--no-wait]
                              [--streaming-units]

Exemplos

Dimensionar um trabalho de streaming

az stream-analytics job scale --job-name "sj59" --resource-group "sjrg6936" --streaming-units 36

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--streaming-units

Especifica o número de unidades de streaming para as quais o trabalho de streaming será dimensionado.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job show

Obtenha detalhes sobre o trabalho de streaming especificado.

az stream-analytics job show --job-name --name
                             --resource-group
                             [--expand]

Exemplos

Obter um trabalho de streaming e não usar o parâmetro de consulta OData $expand

az stream-analytics job show --job-name "sj59" --resource-group "sjrg6936"

Obtenha um trabalho de streaming e use o parâmetro de consulta OData $expand para expandir entradas, saídas, transformação e funções

az stream-analytics job show --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276"

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--expand

O parâmetro de consulta OData $expand. Esta é uma lista separada por vírgulas de propriedades de trabalho de streaming adicionais a serem incluídas na resposta, além do conjunto padrão retornado quando esse parâmetro está ausente. O conjunto padrão é todas as propriedades de trabalho de streaming que não sejam 'entradas', 'transformação', 'saídas' e 'funções'.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job start

Inicie um trabalho de streaming. Depois que um trabalho for iniciado, ele começará a processar eventos de entrada e produzirá a saída.

az stream-analytics job start --job-name --name
                              --resource-group
                              [--no-wait]
                              [--output-start-mode {CustomTime, JobStartTime, LastOutputEventTime}]
                              [--output-start-time]

Exemplos

Iniciar um trabalho de streaming com o modo de início de saída CustomTime

az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "CustomTime" --output-start-time "2012-12-12T12:12:12Z"

Iniciar um trabalho de streaming com o modo de início de saída JobStartTime

az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "JobStartTime"

Iniciar um trabalho de streaming com o modo de início de saída LastOutputEventTime

az stream-analytics job start --job-name "sj59" --resource-group "sjrg6936" --output-start-mode "LastOutputEventTime"

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--output-start-mode

O valor pode ser JobStartTime, CustomTime ou LastOutputEventTime para indicar se o ponto inicial do fluxo de eventos de saída deve ser iniciado sempre que o trabalho for iniciado, iniciar em um carimbo de data/hora do usuário personalizado especificado por meio da propriedade outputStartTime ou iniciar a partir da hora de saída do último evento.

Propriedade Valor
Valores aceitos: CustomTime, JobStartTime, LastOutputEventTime
--output-start-time

O valor é um carimbo de data/hora formatado ISO-8601 que indica o ponto inicial do fluxo de eventos de saída ou nulo para indicar que o fluxo de eventos de saída será iniciado sempre que o trabalho de streaming for iniciado. Essa propriedade deve ter um valor se outputStartMode estiver definido como CustomTime.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job stop

Pare um trabalho de streaming em execução. Isso fará com que um trabalho de streaming em execução pare de processar eventos de entrada e produzir saída.

az stream-analytics job stop --job-name --name
                             --resource-group
                             [--no-wait]

Exemplos

Parar um trabalho de streaming

az stream-analytics job stop --job-name "sj59" --resource-group "sjrg6936"

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job update

Atualize um trabalho de streaming existente. Isso pode ser usado para atualizar parcialmente (ou seja, atualizar uma ou duas propriedades) um trabalho de streaming sem afetar o restante da definição do trabalho.

az stream-analytics job update --job-name --name
                               --resource-group
                               [--arrival-max-delay]
                               [--compatibility-level {1.0, 1.2}]
                               [--content-storage-policy {JobStorageAccount, SystemAccount}]
                               [--data-locale]
                               [--functions]
                               [--id]
                               [--identity]
                               [--if-match]
                               [--inputs]
                               [--job-storage-account]
                               [--job-type {Cloud, Edge}]
                               [--location]
                               [--order-max-delay]
                               [--out-of-order-policy {Adjust, Drop}]
                               [--output-error-policy {Drop, Stop}]
                               [--output-start-mode {CustomTime, JobStartTime, LastOutputEventTime}]
                               [--output-start-time]
                               [--outputs]
                               [--tags]
                               [--transformation]

Exemplos

Atualizar um trabalho de streaming

az stream-analytics job update --job-name "sj59" --resource-group "sjrg6936" --arrival-max-delay 13 --order-max-delay 21

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--arrival-max-delay

O atraso tolerável máximo em segundos em que os eventos que chegam tarde podem ser incluídos. O intervalo com suporte é -1 para 1814399 (20,23:59:59 dias) e -1 é usado para especificar a espera indefinidamente. Se a propriedade estiver ausente, ela será interpretada para ter um valor de -1.

--compatibility-level

Controla determinados comportamentos de runtime do trabalho de streaming.

Propriedade Valor
Valores aceitos: 1.0, 1.2
--content-storage-policy

Os valores válidos são JobStorageAccount e SystemAccount. Se definido como JobStorageAccount, isso requer que o usuário também especifique a propriedade jobStorageAccount. .

Propriedade Valor
Valores aceitos: JobStorageAccount, SystemAccount
--data-locale

A localidade de dados do trabalho de análise de fluxo. O valor deve ser o nome de uma cultura .NET com suporte do conjunto https://msdn.microsoft.com/en-us/library/system.globalization.culturetypes(v=vs.110).aspx. O padrão é 'en-US' se nenhum especificado.

--functions

Uma lista de uma ou mais funções para o trabalho de streaming. A propriedade de nome para cada função é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a transformação individual. Valor esperado: json-string/json-file/@json-file.

--id

A ID do recurso do cluster.

Propriedade Valor
Grupo de parâmetros: Cluster Arguments
--identity

Descreva a identidade gerenciada atribuída pelo sistema atribuída a esse trabalho que pode ser usada para autenticar com entradas e saídas.

Uso: --identity tenant-id=XX principal-id=XX type=XX

tenant-id: The identity tenantId principal-id: The identity principal ID type: The identity type.

--if-match

A ETag do trabalho de streaming. Omita esse valor para sempre substituir o conjunto de registros atual. Especifique o valor de ETag visto pela última vez para impedir a substituição acidental de alterações simultâneas.

--inputs

Uma lista de uma ou mais entradas para o trabalho de streaming. A propriedade de nome para cada entrada é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a entrada individual. Valor esperado: json-string/json-file/@json-file.

--job-storage-account

As propriedades associadas a uma conta de Armazenamento do Azure com MSI.

Uso: --job-storage-account authentication-mode=XX account-name=XX account-key=XX

modo de autenticação: modo de autenticação. nome da conta: o nome da conta de Armazenamento do Azure. Obrigatório em solicitações PUT (CreateOrReplace). chave de conta: a chave da conta para a conta de Armazenamento do Azure. Obrigatório em solicitações PUT (CreateOrReplace).

--job-type

Descreve o tipo do trabalho. Os modos válidos são Cloud e 'Edge'.

Propriedade Valor
Valores aceitos: Cloud, Edge
--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--order-max-delay

O atraso tolerável máximo em segundos em que os eventos fora de ordem podem ser ajustados para estarem de volta em ordem.

--out-of-order-policy

Indica a política a ser aplicada a eventos que chegam fora de ordem no fluxo de eventos de entrada.

Propriedade Valor
Valores aceitos: Adjust, Drop
--output-error-policy

Indica a política a ser aplicada a eventos que chegam à saída e não podem ser gravados no armazenamento externo devido à má formação (valores de coluna ausentes, valores de coluna de tipo ou tamanho incorretos).

Propriedade Valor
Valores aceitos: Drop, Stop
--output-start-mode

Essa propriedade só deve ser utilizada quando desejar que o trabalho seja iniciado imediatamente após a criação. O valor pode ser JobStartTime, CustomTime ou LastOutputEventTime para indicar se o ponto inicial do fluxo de eventos de saída deve ser iniciado sempre que o trabalho for iniciado, iniciar em um carimbo de data/hora do usuário personalizado especificado por meio da propriedade outputStartTime ou iniciar a partir da hora de saída do último evento.

Propriedade Valor
Valores aceitos: CustomTime, JobStartTime, LastOutputEventTime
--output-start-time

O valor é um carimbo de data/hora formatado ISO-8601 que indica o ponto inicial do fluxo de eventos de saída ou nulo para indicar que o fluxo de eventos de saída será iniciado sempre que o trabalho de streaming for iniciado. Essa propriedade deve ter um valor se outputStartMode estiver definido como CustomTime.

--outputs

Uma lista de uma ou mais saídas para o trabalho de streaming. A propriedade de nome para cada saída é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a saída individual. Valor esperado: json-string/json-file/@json-file.

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--transformation

Indique a consulta e o número de unidades de streaming a serem usadas para o trabalho de streaming. A propriedade de nome da transformação é necessária ao especificar essa propriedade em uma solicitação PUT. Essa propriedade não pode ser modificada por meio de uma operação PATCH. Você deve usar a API PATCH disponível para a transformação individual.

Uso: --transformation streaming-units=XX valid-streaming-units=XX query=XX name=XX

unidades de streaming: especifica o número de unidades de streaming que o trabalho de streaming usa. valid-streaming-units: especifica as unidades de streaming válidas para as quais um trabalho de streaming pode ser dimensionado. consulta: especifica a consulta que será executada no trabalho de streaming. Saiba mais sobre a SAQL (Linguagem de Consulta do Stream Analytics) aqui: https://msdn.microsoft.com/library/azure/dn834998 . Obrigatório em solicitações PUT (CreateOrReplace). nome: Nome do recurso.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az stream-analytics job wait

Coloque a CLI em um estado de espera até que uma condição do trabalho de análise de fluxo seja atendida.

az stream-analytics job wait --job-name --name
                             --resource-group
                             [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--expand]
                             [--interval]
                             [--timeout]
                             [--updated]

Exemplos

Pause a execução da próxima linha de script da CLI até que o trabalho de análise de fluxo seja criado com êxito.

az stream-analytics job wait --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276" --created

Pause a execução da próxima linha de script da CLI até que o trabalho de análise de fluxo seja excluído com êxito.

az stream-analytics job wait --expand "inputs,outputs,transformation,functions" --job-name "sj7804" --resource-group "sjrg3276" --deleted

Parâmetros Exigidos

--job-name --name -n

O nome do trabalho de streaming.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--expand

O parâmetro de consulta OData $expand. Esta é uma lista separada por vírgulas de propriedades de trabalho de streaming adicionais a serem incluídas na resposta, além do conjunto padrão retornado quando esse parâmetro está ausente. O conjunto padrão é todas as propriedades de trabalho de streaming que não sejam 'entradas', 'transformação', 'saídas' e 'funções'.

--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False