azdata notebook

Aplica-se a: CLI de Dados do Azure (azdata)

Observação

Alguns cenários tratados anteriormente pela CLI de Dados do Azure (azdata) agora são gerenciados por meio de extensões da CLI do Azure (az) e fluxos de trabalho baseados no Azure Arc. Não há uma única substituição 1:1 para todos os azdata comandos. A tabela a seguir realça alternativas da CLI do Azure comumente relacionadas onde elas existem.

azdata command area	Extensão/grupo de comandos da CLI do Azure	Referência do Azure CLI
azdata arc dc *	az arcdata	Referência da CLI de dados do Azure Arc
azdata arc sql mi *	az arcdata sql mi	Gerenciar a Instância Gerenciada de SQL do Azure com a CLI
azdata arc postgres *	az arcdata postgres	Gerenciar o servidor PostgreSQL com a CLI
azdata migrate *	az datamigration	Migrar usando a CLI
azdata extension *	az extension *	Visão geral das extensões da CLI do Azure
azdata login	az login	az login
azdata sql shell / azdata sql query	Nenhuma CLI do Azure equivalente (use sqlcmd, SSMS ou outras ferramentas SQL)	Utilitário sqlcmd SQL Server Management Studio

Para novos cenários de automação e gerenciamento, prefira a CLI do Azure (az), as extensões da CLI do Azure e as experiências do portal do Azure Arc.

O artigo a seguir fornece referência para os comandos sql na ferramenta azdata. Para obter mais informações sobre outros comandos de azdata, confira referência de azdata

Comandos

Command	Descrição
azdata notebook view	Exibir um bloco de anotações. Opção para interromper no primeiro erro de execução da célula.
azdata notebook run	Execute um bloco de anotações. A execução é interrompida no primeiro erro.

azdata notebook view

Esse comando pode pegar um arquivo de notebook e converter o markdown, o código e a saída em formato de terminal de cores.

azdata notebook view --path -p 
                     [--continue-on-error -c]

Exemplos

Exibir bloco de anotações. Isso mostra todas as células.

azdata notebook view --path "/home/me/notebooks/demo_notebook.ipynb"

Exibir bloco de anotações. Isso mostra todas as células, a menos que uma célula com erro na saída seja encontrada. Nesse caso, a saída é interrompida.

azdata notebook view --path "/home/me/notebooks/demo_notebook.ipynb" --stop-on-error

Parâmetros Necessários

--path -p

O caminho para o bloco de anotações a ser exibido.

Parâmetros opcionais

--continue-on-error -c

Continue exibindo células adicionais ignorando os erros de célula encontrados na saída do notebook. O comportamento padrão é parar mediante um erro. Parar facilita a visualização da primeira célula que encontrou um erro.

Argumentos globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--output -o

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

--query -q

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

--verbose

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

azdata notebook run

Esse comando cria um diretório temporário e executa o bloco de anotações especificado dentro dele como o diretório de trabalho.

azdata notebook run --path -p 
                    [--output-path]  
                    
[--output-html]  
                    
[--arguments -a]  
                    
[--interactive -i]  
                    
[--clear -c]  
                    
[--timeout -t]  
                    
[--env -e]

Exemplos

Execute o notebook.

azdata notebook run --path "/home/me/notebooks/demo_notebook.ipynb"

Parâmetros Necessários

--path -p

O caminho do arquivo para o notebook a ser executado.

Parâmetros opcionais

--output-path

Caminho do diretório a ser usado para a saída do notebook. O notebook com dados de saída e todos os arquivos gerados pelo notebook são gerados em relação a esse diretório.

--output-html

Sinalizador opcional que indica se o notebook de saída deve ser convertido adicionalmente no formato HTML. Cria um segundo arquivo de saída.

--arguments -a

Lista opcional de argumentos de bloco de anotações a serem injetados na execução do notebook. Codificado como um dicionário JSON. Exemplo: '{"name":"value", "name2":"value2"}'

--interactive -i

Execute um bloco de anotações em um modo interativo.

--clear -c

No modo interativo, desmarque o console antes de renderizar uma célula.

--timeout -t

Segundos para aguardar a conclusão da execução. O valor -1 indica esperar para sempre. 600

--env -e

Nome do ambiente. base

Argumentos globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--output -o

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

--query -q

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

--verbose

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

Próximas Etapas 

Para obter mais informações sobre outros comandos de azdata, confira referência de azdata.

Para saber mais sobre como instalar a ferramenta azdata, confira Instalar azdata.