azdata sql

Se aplica a: CLI de datos de Azure (azdata)

Nota:

Algunos escenarios previamente administrados por la CLI de datos de Azure (azdata) ahora se administran mediante extensiones de la CLI de Azure (az) y flujos de trabajo basados en Azure Arc. No hay ningún reemplazo único de 1:1 para todos los azdata comandos. En la tabla siguiente se resaltan las alternativas comunes de la CLI de Azure en las que existen.

área de comandos azdata	Extensión o grupo de comandos de la CLI de Azure	referencia de Azure CLI
azdata arc dc *	az arcdata	Referencia de la CLI de datos de Azure Arc
azdata arc sql mi *	az arcdata sql mi	Administración de Azure SQL Managed Instance con la CLI
azdata arc postgres *	az arcdata postgres	Administración del servidor PostgreSQL con la CLI
azdata migrate *	az datamigration	Migración mediante la CLI
azdata extension *	az extension *	Introducción a las extensiones de la CLI de Azure
azdata login	az login	inicio de sesión de az
azdata sql shell / azdata sql query	Ningún equivalente de la CLI de Azure (use sqlcmd, SSMS u otras herramientas de SQL)	Utilidad sqlcmd SQL Server Management Studio

Para nuevos escenarios de automatización y administración, prefiera la CLI de Azure (az),las extensiones de la CLI de Azure y las experiencias del portal de Azure Arc.

En el siguiente artículo se proporciona una referencia de los comandos sql de la herramienta azdata. Para obtener más información sobre otros comandos de azdata, vea la Referencia de azdata.

Commands

Comando	Descripción
azdata sql shell	La CLI de SQL permite al usuario interactuar con SQL Server y Azure SQL a través de T-SQL.
azdata sql query	La CLI de SQL permite al usuario interactuar con SQL Server y Azure SQL a través de T-SQL.

azdata sql shell

La CLI de SQL permite al usuario interactuar con SQL Server y Azure SQL a través de 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]

Ejemplos

Línea de comandos de ejemplo para iniciar la experiencia interactiva.

azdata sql shell

Línea de comandos de ejemplo con un servidor, un usuario y una base de datos proporcionados

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

Parámetros opcionales

--username -u

Nombre de usuario para conectarse a la base de datos.

--database -d

Nombre de la base de datos al que conectarse.

--server -s

Nombre o dirección de la instancia de SQL Server.

--integrated -e

Use la autenticación integrada en Windows.

--mssqlclirc

Ubicación del archivo de configuración mssqlclirc.

--row-limit

Establezca el umbral para la solicitud de límite de filas. Use 0 para deshabilitar la solicitud.

--less-chatty

Omita la introducción al inicio y adiós al salir.

--auto-vertical-output

Cambie automáticamente al modo de salida vertical si el resultado es más ancho que el ancho del terminal.

--encrypt -n

SQL Server usa el cifrado SSL para todos los datos si el servidor tiene instalado un certificado.

--trust-server-certificate -c

El canal se cifrará mientras se pasa el recorrido de la cadena de certificados para validar la confianza.

--connect-timeout -l

Tiempo en segundos para esperar una conexión al servidor antes de finalizar la solicitud.

--application-intent -k

Declara el tipo de carga de trabajo de aplicación al conectarse a una base de datos en un grupo de disponibilidad de SQL Server.

--multi-subnet-failover -m

Si la aplicación se conecta al grupo de disponibilidad AlwaysOn en diferentes subredes, esta opción proporciona una detección y conexión más rápidas al servidor activo actualmente.

--packet-size

Tamaño en bytes de los paquetes de red que se usan para comunicarse con SQL Server.

--dac-connection -a

Conéctese a SQL Server mediante la conexión de administrador dedicada.

--input-file -i

Especifica el archivo que contiene un lote de instrucciones SQL para su procesamiento.

--output-file

Especifica el archivo que recibe la salida de una consulta.

--enable-sqltoolsservice-logging

Habilita el registro de diagnóstico para SqlToolsService.

--prompt

Formato del símbolo del sistema (valor predeterminado: \d>

Argumentos globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--output -o

Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.

--query -q

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

azdata sql query

La CLI de SQL permite al usuario interactuar con SQL Server y Azure SQL a través de T-SQL.

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

Ejemplos

Línea de comandos de ejemplo para seleccionar la lista de nombres de tablas.

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

Parámetros necesarios

-q

Consulta T-SQL que se va a ejecutar.

Parámetros opcionales

--database -d

Nombre de la base de datos al que conectarse. master

--username -u

Nombre de usuario para conectarse a la base de datos.

--server -s

Nombre o dirección de la instancia de SQL Server.

--integrated -e

Use la autenticación integrada en Windows.

Argumentos globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--output -o

Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.

--query -q

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Pasos siguientes

Para obtener más información sobre otros comandos de azdata, vea Referencia de azdata.

Para más información sobre cómo instalar la herramienta azdata, consulte Instalación de azdata.