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).
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"}