azdata

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 Referencia de azdata.

Commands

Comando	Descripción
azdata arc	Comandos para usar Azure Arc para los servicios de datos de Azure.
azdata sql	La CLI de SQL DB permite al usuario interactuar con SQL Server a través de T-SQL.
azdata login	Inicie sesión en el punto de conexión del controlador del clúster y establezca su espacio de nombres como contexto activo. Para usar una contraseña en el inicio de sesión, debe establecer la variable de entorno AZDATA_PASSWORD.
azdata logout	Cierre la sesión del clúster.
azdata context	Comandos de administración de contexto.
azdata bdc	Seleccione, administre y opere clústeres de macrodatos de SQL Server.
extensión azdata	Administre y actualice extensiones de la CLI.
azdata app	Crear, eliminar, ejecutar y administrar aplicaciones.
azdata postgres	Ejecutor de consultas de Postgres e shell interactivo.
azdata notebook	Comandos para ver, ejecutar y administrar cuadernos desde un terminal.

azdata login

Cuando se implemente el clúster, se mostrará el punto de conexión del controlador durante la implementación, que debe usar para iniciar sesión. Si no conoce el punto de conexión del controlador, puede iniciar sesión teniendo la configuración kube del clúster en el sistema en la ubicación predeterminada del <usuario home>/.kube/config o usar kuBECONFIG env var, es decir, exportar KUBECONFIG=path/to/.kube/config. Al iniciar sesión, el espacio de nombres de este clúster se establecerá en el contexto activo.

azdata login [--auth] 
             [--endpoint -e]  
             
[--accept-eula -a]  
             
[--namespace -ns]  
             
[--username -u]  
             
[--principal -p]

Ejemplos

Inicio de sesión con autenticación básica.

azdata login --auth basic --username johndoe --endpoint https://<ip or domain name>:30080

Inicio de sesión con Active Directory.

azdata login --auth ad --endpoint https://<ip or domain name>:30080                

Inicie sesión con Active Directory con una entidad de seguridad explícita.

azdata login --auth ad --principal johndoe@COSTOSO.COM --endpoint https://<ip or domain name>:30080

Iniciar sesión de forma interactiva. Siempre se solicitará el nombre del clúster si no se especifica como argumento. Si tiene las variables de AZDATA_USERNAME, AZDATA_PASSWORD y ACCEPT_EULA env establecidas en el sistema, no se le pedirá. Si tiene la configuración kube en el sistema o usa KUBECONFIG env var para especificar la ruta de acceso a la configuración, la experiencia interactiva intentará usar primero la configuración y, a continuación, le preguntará si se produce un error en la configuración.

azdata login

Inicie sesión (de forma no interactiva). Inicie sesión con el nombre del clúster, el nombre de usuario del controlador, el punto de conexión del controlador y la aceptación del CLUF establecidos como argumentos. Se debe establecer la variable de entorno AZDATA_PASSWORD. Si no desea especificar el punto de conexión del controlador, tenga la configuración kube en la máquina en la ubicación predeterminada de <user home>/.kube/config o use kuBECONFIG env var, es decir, export KUBECONFIG=path/to/.kube/config.

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

Inicie sesión con kube config en la máquina y env var establecido para AZDATA_USERNAME, AZDATA_PASSWORD y ACCEPT_EULA.

azdata login -n ClusterName

Parámetros opcionales

--auth

Estrategia de autenticación. Autenticación básica o de Active Directory. El valor predeterminado es la autenticación "básica".

--endpoint -e

Punto de conexión del controlador de clúster "https://host:port". Si no desea usar este argumento, puede usar la configuración kube en la máquina. Asegúrese de que la configuración se encuentra en la ubicación predeterminada de <user home>/.kube/config o use kuBECONFIG env var.

--accept-eula -a

¿Acepta los términos de licencia? [Sí/no]. Si no desea usar este argumento, puede establecer la variable de entorno ACCEPT_EULA en "sí". Los términos de licencia de este producto se pueden ver en https://aka.ms/eula-azdata-en.

--namespace -ns

Espacio de nombres del plano de control del clúster.

--username -u

Usuario de la cuenta. Si no desea usar este argumento, puede establecer la variable de entorno AZDATA_USERNAME.

--principal -p

Su dominio kerberos. En la mayoría de los casos, el dominio kerberos es el nombre de dominio, en letras mayúsculas.

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 logout

Cierre la sesión del clúster.

azdata logout 

Ejemplos

Cierre la sesión de este usuario.

azdata logout

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.