azdata

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 arc	Comandos para usar o Azure Arc para serviços de dados do Azure.
azdata sql	A CLI do BD SQL permite que o usuário interaja com o SQL Server por meio do T-SQL.
logon do azdata	Faça logon no ponto de extremidade do controlador do cluster e defina seu namespace como seu contexto ativo. Para usar uma senha no logon, você deve definir a variável de ambiente AZDATA_PASSWORD.
azdata logout	Faça logoff do cluster.
contexto azdata	Comandos de gerenciamento de contexto.
azdata bdc	Selecione, gerencie e opere clusters de Big Data do SQL Server.
extensão azdata	Gerencia e atualiza as extensões da CLI.
azdata app	Criar, excluir, executar e gerenciar aplicativos.
azdata postgres	Executor de consulta postgres e shell interativo.
azdata notebook	Comandos para exibir, executar e gerenciar notebooks de um terminal.

logon do azdata

Quando o cluster for implantado, ele listará o ponto de extremidade do controlador durante a implantação, que você deve usar para fazer logon. Se você não souber o ponto de extremidade do controlador, poderá fazer logon tendo a configuração kube do cluster em seu sistema no local padrão da página inicial> do <usuário/.kube/config ou usar o env var KUBECONFIG, ou seja, exportar KUBECONFIG=path/to/.kube/config. Quando você fizer logon, o namespace desse cluster será definido como seu contexto ativo.

azdata login [--auth] 
             [--endpoint -e]  
             
[--accept-eula -a]  
             
[--namespace -ns]  
             
[--username -u]  
             
[--principal -p]

Exemplos

Faça logon usando a autenticação básica.

azdata login --auth basic --username johndoe --endpoint https://<ip or domain name>:30080

Faça logon usando o Active Directory.

azdata login --auth ad --endpoint https://<ip or domain name>:30080                

Faça logon usando o active directory com uma entidade de segurança explícita.

azdata login --auth ad --principal johndoe@COSTOSO.COM --endpoint https://<ip or domain name>:30080

Fazer logon interativamente. O nome do cluster sempre será solicitado se não for especificado como um argumento. Se você tiver as variáveis de AZDATA_USERNAME, AZDATA_PASSWORD e ACCEPT_EULA de desenvolvimento definidas em seu sistema, elas não serão solicitadas. Se você tiver a configuração kube em seu sistema ou estiver usando o env var KUBECONFIG para especificar o caminho para a configuração, a experiência interativa primeiro tentará usar a configuração e, em seguida, solicitará se a configuração falhar.

azdata login

Faça logon (não interativamente). Faça logon com o nome do cluster, o nome de usuário do controlador, o ponto de extremidade do controlador e o conjunto de aceitação do EULA como argumentos. A variável de ambiente AZDATA_PASSWORD deve ser definida. Se você não quiser especificar o ponto de extremidade do controlador, tenha a configuração kube em seu computador no local padrão da página inicial> do <usuário/.kube/config ou use o env var KUBECONFIG, ou seja, exporte KUBECONFIG=path/to/.kube/config.

azdata login --namespace ClusterName --username johndoe@contoso.com  --endpoint https://<ip or domain name>:30080 --accept-eula yes

Faça logon com a configuração kube no computador e o env var definido para AZDATA_USERNAME, AZDATA_PASSWORD e ACCEPT_EULA.

azdata login -n ClusterName

Parâmetros opcionais

--auth

A estratégia de autenticação. Autenticação básica ou do Active Directory. O padrão é a autenticação "básica".

--endpoint -e

Ponto de extremidade do controlador de cluster "https://host:port". Se você não quiser usar esse arg, poderá usar a configuração kube em seu computador. Verifique se a configuração está localizada no local padrão do <usuário home>/.kube/config ou use o env var KUBECONFIG.

--accept-eula -a

Você aceita os termos de licença? [sim/não]. Se você não quiser usar esse arg, poderá definir a variável de ambiente ACCEPT_EULA como "sim". Os termos de licença para este produto podem ser exibidos em https://aka.ms/eula-azdata-en.

--namespace -ns

Namespace do plano de controle do cluster.

--username -u

Usuário da conta. Se você não quiser usar esse arg, poderá definir a variável de ambiente AZDATA_USERNAME.

--principal -p

Seu reino Kerberos. Na maioria dos casos, seu realm Kerberos é seu nome de domínio, em letras maiúsculas e minúsculas.

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 logout

Faça logoff do cluster.

azdata logout 

Exemplos

Faça logon deste usuário.

azdata logout

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.