azdata

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

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

Comando	Descrição
azdata arc	Comandos para usar o Azure Arc para serviços de dados do Azure.
azdata sql	A CLI do banco de dados SQL permite que o usuário interaja com o SQL Server por meio de T-SQL.
azdata login	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, defina a variável de ambiente AZDATA_PASSWORD.
azdata logout	Fazer logoff do cluster.
azdata context	Comandos de gerenciamento de contexto.
azdata bdc	Selecionar, gerenciar e operar clusters de Big Data do SQL Server.
azdata extension	Gerencia e atualiza as extensões da CLI.
azdata app	Criar, excluir, executar e gerenciar aplicativos.
azdata postgres	Shell interativo e executor de consulta do Postgres.
azdata notebook	Comandos para exibir, executar e gerenciar notebooks de um terminal.

azdata login

Quando o cluster for implantado, ele listará o ponto de extremidade do controlador durante a implantação, que você deverá usar para fazer logon. Se você não souber o ponto de extremidade do controlador, você poderá fazer logon colocando a configuração de kube do seu cluster no seu sistema na localização padrão <pasta inicial do usuário>/.kube/config ou usando a variável de ambiente 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 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 será sempre solicitado se não for especificado como um argumento. Se você tiver as variáveis de env AZDATA_USERNAME, AZDATA_PASSWORD e ACCEPT_EULA definidas em seu sistema, elas não serão solicitadas. Se você tiver a configuração de kube em seu sistema ou estiver usando a variável de ambiente KUBECONFIG para especificar o caminho para a configuração, a experiência interativa primeiro tentará usar a configuração e, em seguida, a solicitará se a configuração falhar.

azdata login

Fazer logon (não interativamente). Fazer logon com o nome do cluster, o nome de usuário do controlador, o ponto de extremidade do controlador e o a aceitação do EULA definidos como argumentos. A variável de ambiente AZDATA_PASSWORD precisa ser definida. Se você não quiser especificar o ponto de extremidade do controlador, coloque a configuração de kube em seu computador na localização padrão <pasta inicial do usuário>/.kube/config ou usando a variável de ambiente KUBECONFIG, ou seja, exportar KUBECONFIG=path/to/.kube/config.

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

Fazer logon com configuração de kube no computador e definir as variáveis de ambiente 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 não quiser usar esse argumento, você poderá usar a configuração de kube em seu computador. Verifique se a configuração está na localização padrão de <pasta inicial do usuário>/.kube/config ou use a variável de ambiente KUBECONFIG.

--accept-eula -a

Você aceita os termos de licença? [sim/não]. Se não quiser usar esse argumento, você poderá definir a variável de ambiente ACCEPT_EULA como 'sim'. Os termos de licença desse 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 não quiser usar esse argumento, você poderá definir a variável de ambiente AZDATA_USERNAME.

--principal -p

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

Argumentos globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--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 o detalhamento do log. Use --debug para logs de depuração completos.

azdata logout

Fazer logoff do cluster.

azdata logout 

Exemplos

Fazer logoff deste usuário.

azdata logout

Argumentos globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--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 o detalhamento do 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.