Leer en inglés

Compartir a través de


La interfaz de la línea de comandos de Azure Data Studio

Azure Data Studio incluye una interfaz de línea de comandos integrada que permite controlar cómo se inicia la aplicación. Puede abrir archivos, instalar extensiones, cambiar el idioma de visualización y los diagnósticos de salida a través de opciones de línea de comandos (modificadores).

Captura de pantalla de salida de línea de comandos en Azure Data Studio.

Para obtener ejemplos de cómo ejecutar herramientas de línea de comandos en Azure Data Studio, consulte Terminal integrado.

Nota

Aunque Microsoft Entra ID es el nuevo nombre de Azure Active Directory (Azure AD), para evitar interrumpir los entornos existentes, Azure AD sigue estando en algunos elementos codificados de forma rígida como campos de interfaz de usuario, proveedores de conexiones, códigos de error y cmdlets. En este artículo, los dos nombres son intercambiables.

Ayuda de la línea de comandos

Para ver una introducción a la interfaz de la línea de comandos de Azure Data Studio, abra un terminal en Azure Data Studio (Ver terminal >) o un símbolo del sistema y escriba azuredatastudio --help. La salida contiene la versión, el ejemplo de uso y la lista de opciones de línea de comandos, como se muestra en el ejemplo truncado:

Azure Data Studio 1.48.1

Usage: azuredatastudio.exe [options][paths...]

To read output from another program, append '-' (e.g. 'echo Hello World | azuredatastudio.exe -')

Options

  <vscode options>

  -h --help                                  Print usage.
  --aad                                      Use Azure Active Directory authentication, this option is
                                             deprecated - use 'authenticationType' instead.
  -A --applicationName                       Supports providing applicationName
                                             that will be used for connection profile app name.
  -T --authenticationType                    Provide authentication mode to be
                                             used. Accepted values: AzureMFA, SqlLogin, Integrated, etc.
  -c --command <command-name>                Name of command to run, accepted
                                             values: connect, openConnectionDialog
  -Z --connectionProperties                  Supports providing advanced connection properties that
                                             providers support. Value must be a json object containing
                                             key-value pairs in format: '{"key1":"value1"}'
  -D --database <database>                   Name of database
  -E --integrated                            Use Integrated authentication,
                                             this option is deprecated - use 'authenticationType' instead.
  -P --provider                              Connection provider to use, e.g. MSSQL, PGSQL, etc.
  -S --server <server>                       Name of target server or host name.
  --showDashboard                            Whether or not to show dashboard on connection, false by default.
  -U --user <user-name>                      User name/email address

Iniciar desde la línea de comandos

Puede iniciar Azure Data Studio desde la línea de comandos para abrir rápidamente un archivo, una carpeta o un proyecto. Normalmente, se abre Azure Data Studio en el contexto de una carpeta. Desde un terminal abierto o símbolo del sistema, navegue hasta la carpeta de su proyecto y escriba azuredatastudio.

Inicio mediante el Editor de consultas

A veces, será conveniente que abra un script en el Editor de Power Query al abrir Azure Data Studio. Puede iniciar Azure Data Studio con un script existente proporcionando la ruta de acceso del archivo:

azuredatastudio .\samplescript.sql

Inicio mediante URI

Puede iniciar Azure Data Studio desde el explorador mediante el formato de dirección URL para establecer rápidamente la conexión al iniciarse o abrir un cuadro de diálogo de conexión, si lo desea, abrir un script en el Editor de consultas. El formato admitido para iniciar con URI es:

azuredatastudio://{command}?{option1}={value1}&{option2}={value2}...

Comandos admitidos:

Se admiten los siguientes comandos al iniciar Azure Data Studio desde una línea de comandos:

  • connect: se conecta al servidor de destino mediante las opciones proporcionadas.
  • openConnectionDialog: abre el cuadro de diálogo de conexión mediante las opciones proporcionadas.

Opciones admitidas

En la dirección URL se pueden ofrecer las siguientes opciones.

Opción Descripción
provider Proveedor de conexiones que se va a usar, por ejemplo, MSSQL, PGSQL, etc.
server Nombre del servidor de destino o nombre de host.
database Nombre de la base de datos.
user Nombre del usuario.
authenticationType Modo de autenticación que se va a usar, valores aceptados: AzureMFA, SqlLogin, Integrated, etc.
applicationName Proporcione un nombre de aplicación que se use en el perfil de conexión.
connectionProperties Propiedades de conexión avanzadas que admite un proveedor. El valor debe ser un objeto json que contenga pares clave-valor en formato {"key1":"value1"}.

Ejemplos

Símbolo del sistema: autenticación integrada

azuredatastudio --server localhost --authenticationType Integrated

Es posible que se le pida una advertencia de "Certificado de servidor de confianza".

Nota

Para los usuarios que se conectan en el entorno local de SQL Server o SQL Server en una máquina virtual, el Motor de base de datos debe configurarse para admitir conexiones cifradas. Para acceder a las instrucciones completas, consulte Configuración del Motor de base de datos de SQL Server para el cifrado de las conexiones.

Símbolo del sistema: Iniciar Azure Data Studio con un script guardado

azuredatastudio --server localhost --provider mssql --user sa .\samplescript.sql

Browser

azuredatastudio://connect?server=*****&user=*****&authenticationType=*****&connectionProperties={"key1":"value1"}

Pasos siguientes