azdata sql

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 sql shell	A CLI do SQL permite que o usuário interaja com o SQL Server e o SQL do Azure por meio do T-SQL.
azdata sql query	A CLI do SQL permite que o usuário interaja com o SQL Server e o SQL do Azure por meio do T-SQL.

azdata sql shell

A CLI do SQL permite que o usuário interaja com o SQL Server e o SQL do Azure por meio do T-SQL.

azdata sql shell [--username -u] 
                 [--database -d]  
                 
[--server -s]  
                 
[--integrated -e]  
                 
[--mssqlclirc]  
                 
[--row-limit]  
                 
[--less-chatty]  
                 
[--auto-vertical-output]  
                 
[--encrypt -n]  
                 
[--trust-server-certificate -c]  
                 
[--connect-timeout -l]  
                 
[--application-intent -k]  
                 
[--multi-subnet-failover -m]  
                 
[--packet-size]  
                 
[--dac-connection -a]  
                 
[--input-file -i]  
                 
[--output-file]  
                 
[--enable-sqltoolsservice-logging]  
                 
[--prompt]

Exemplos

Exemplo de linha de comando para iniciar a experiência interativa.

azdata sql shell

Exemplo de linha de comando usando um servidor, um usuário e um banco de dados fornecidos

azdata sql shell --server localhost --username sa --database master         

Parâmetros opcionais

--username -u

Nome de usuário para se conectar ao banco de dados.

--database -d

Nome do banco de dados ao qual se conectar.

--server -s

Nome ou endereço da instância do SQL Server.

--integrated -e

Use a autenticação integrada no Windows.

--mssqlclirc

Local do arquivo de configuração mssqlclirc.

--row-limit

Defina o limite para o prompt de limite de linha. Use 0 para desabilitar o prompt.

--less-chatty

Ignore a introdução na inicialização e adeus na saída.

--auto-vertical-output

Alterne automaticamente para o modo de saída vertical se o resultado for maior que a largura do terminal.

--encrypt -n

O SQL Server usará a criptografia SSL para todos os dados se o servidor tiver um certificado instalado.

--trust-server-certificate -c

O canal será criptografado ao ignorar a cadeia de certificados para validar a confiança.

--connect-timeout -l

Tempo em segundos para aguardar uma conexão com o servidor antes de encerrar a solicitação.

--application-intent -k

Declara o tipo de carga de trabalho do aplicativo ao se conectar a um banco de dados em um Grupo de Disponibilidade do SQL Server.

--multi-subnet-failover -m

Se o aplicativo estiver se conectando ao AG Always On em sub-redes diferentes, a configuração fornecerá uma detecção e conexão mais rápidas com o servidor ativo no momento.

--packet-size

Tamanho em bytes dos pacotes de rede usados para se comunicar com o SQL Server.

--dac-connection -a

Conecte-se ao SQL Server usando a conexão de administrador dedicada.

--input-file -i

Especifica o arquivo que contém um lote de instruções SQL para processamento.

--output-file

Especifica o arquivo que recebe a saída de uma consulta.

--enable-sqltoolsservice-logging

Habilita o log de diagnóstico para o SqlToolsService.

--prompt

Formato do prompt (padrão: \d>

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 sql query

A CLI do SQL permite que o usuário interaja com o SQL Server e o SQL do Azure por meio do T-SQL.

azdata sql query -q 
                 [--database -d]  
                 
[--username -u]  
                 
[--server -s]  
                 
[--integrated -e]

Exemplos

Exemplo de linha de comando para selecionar a lista de nomes de tabelas.

azdata sql query --server localhost --username sa --database master -q "SELECT name FROM SYS.TABLES"

Parâmetros Necessários

-q

Consulta T-SQL a ser executada.

Parâmetros opcionais

--database -d

Nome do banco de dados ao qual se conectar. master

--username -u

Nome de usuário para se conectar ao banco de dados.

--server -s

Nome ou endereço da instância do SQL Server.

--integrated -e

Use a autenticação integrada no Windows.

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.