Share via

az kusto database

  • Habilitación de características
  • Referencia

Nota:

Esta referencia forma parte de la extensión kusto para la CLI de Azure (versión 2.15.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az kusto database . Obtenga más información sobre las extensiones.

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administrar la base de datos con kusto.

Comandos

Nombre Description Tipo Estado
az kusto database add-principal

Agregue permisos de entidades de seguridad de base de datos.

 Extensión Habilitación de características
az kusto database create

Crear una base de datos.

 Extensión Habilitación de características
az kusto database delete

Elimina la base de datos con el nombre especificado.

 Extensión Habilitación de características
az kusto database list

Devuelve la lista de bases de datos del clúster de Kusto especificado.

 Extensión Habilitación de características
az kusto database list-principal

Devuelve una lista de entidades de seguridad de base de datos del clúster y la base de datos de Kusto especificados.

 Extensión Habilitación de características
az kusto database remove-principal

Quite los permisos de entidades de seguridad de base de datos.

 Extensión Habilitación de características
az kusto database show

Devuelve una base de datos.

 Extensión Habilitación de características
az kusto database update

Novedades una base de datos.

 Extensión Habilitación de características
az kusto database wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de la base de datos kusto.

 Extensión Habilitación de características

az kusto database add-principal

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue permisos de entidades de seguridad de base de datos.

az kusto database add-principal [--cluster-name]
                                [--database-name]
                                [--ids]
                                [--resource-group]
                                [--subscription]
                                [--value]

Ejemplos

KustoDatabaseAddPrincipals

az kusto database add-principal --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --value name="Some User" type="User" app-id="" email="user@microsoft.com" fqn="aaduser=some_guid" role="Admin" --value name="Kusto" type="Group" app-id="" email="kusto@microsoft.com" fqn="aadgroup=some_guid" role="Viewer" --value name="SomeApp" type="App" app-id="some_guid_app_id" email="" fqn="aadapp=some_guid_app_id" role="Admin" --resource-group "kustorptest"

Parámetros opcionales

--cluster-name

Nombre del clúster de Kusto.

--database-name

Nombre de la base de datos en el clúster de Kusto.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--value

Lista de entidades de seguridad de base de datos de Kusto.

Uso: --value role=XX name=XX type=XX fqn=XX email=XX app-id=XX

role: obligatorio. Rol de entidad de seguridad de base de datos. name: Necesario. Nombre principal de la base de datos. type: Obligatorio. Tipo de entidad de seguridad de base de datos. fqn: nombre completo de la entidad de seguridad de base de datos. correo electrónico: correo electrónico de entidad de seguridad de base de datos si existe. app-id: id. de aplicación: solo relevante para el tipo de entidad de seguridad de la aplicación.

Se pueden especificar varias acciones mediante más de un argumento --value.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database create

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Crear una base de datos.

az kusto database create --cluster-name
                         --database-name
                         --resource-group
                         [--no-wait]
                         [--read-only-following-database]
                         [--read-write-database]

Ejemplos

Kusto ReadWrite database create or update

az kusto database create --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --read-write-database location="westus" soft-delete-period="P1D" --resource-group "kustorptest"

Parámetros requeridos

--cluster-name

Nombre del clúster de Kusto.

--database-name

Nombre de la base de datos en el clúster de Kusto.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--read-only-following-database

Clase que representa una base de datos de solo lectura siguiente.

Uso: --read-only-following-database hot-cache-period=XX location=XX kind=XX

período de caché activa: el tiempo en que los datos se deben mantener en caché para consultas rápidas en TimeSpan. location: ubicación del recurso. kind: Obligatorio. Tipo de base de datos.

--read-write-database

Clase que representa una base de datos de escritura de lectura.

Uso: --read-write-database soft-delete-period=XX hot-cache-period=XX location=XX kind=XX

soft-delete-period: el tiempo que deben conservarse los datos antes de dejar de ser accesibles para las consultas en TimeSpan. período de caché activa: el tiempo en que los datos se deben mantener en caché para consultas rápidas en TimeSpan. location: ubicación del recurso. kind: Obligatorio. Tipo de base de datos.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database delete

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimina la base de datos con el nombre especificado.

az kusto database delete [--cluster-name]
                         [--database-name]
                         [--ids]
                         [--no-wait]
                         [--resource-group]
                         [--subscription]
                         [--yes]

Ejemplos

KustoDatabasesDelete

az kusto database delete --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest"

Parámetros opcionales

--cluster-name

Nombre del clúster de Kusto.

--database-name

Nombre de la base de datos en el clúster de Kusto.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database list

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Devuelve la lista de bases de datos del clúster de Kusto especificado.

az kusto database list --cluster-name
                       --resource-group

Ejemplos

KustoDatabasesListByCluster

az kusto database list --cluster-name "kustoclusterrptest4" --resource-group "kustorptest"

Parámetros requeridos

--cluster-name

Nombre del clúster de Kusto.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database list-principal

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Devuelve una lista de entidades de seguridad de base de datos del clúster y la base de datos de Kusto especificados.

az kusto database list-principal --cluster-name
                                 --database-name
                                 --resource-group

Ejemplos

KustoDatabaseListPrincipals

az kusto database list-principal --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest"

Parámetros requeridos

--cluster-name

Nombre del clúster de Kusto.

--database-name

Nombre de la base de datos en el clúster de Kusto.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database remove-principal

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Quite los permisos de entidades de seguridad de base de datos.

az kusto database remove-principal [--cluster-name]
                                   [--database-name]
                                   [--ids]
                                   [--resource-group]
                                   [--subscription]
                                   [--value]

Ejemplos

KustoDatabaseRemovePrincipals

az kusto database remove-principal --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --value name="Some User" type="User" app-id="" email="user@microsoft.com" fqn="aaduser=some_guid" role="Admin" --value name="Kusto" type="Group" app-id="" email="kusto@microsoft.com" fqn="aadgroup=some_guid" role="Viewer" --value name="SomeApp" type="App" app-id="some_guid_app_id" email="" fqn="aadapp=some_guid_app_id" role="Admin" --resource-group "kustorptest"

Parámetros opcionales

--cluster-name

Nombre del clúster de Kusto.

--database-name

Nombre de la base de datos en el clúster de Kusto.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--value

Lista de entidades de seguridad de base de datos de Kusto.

Uso: --value role=XX name=XX type=XX fqn=XX email=XX app-id=XX

role: obligatorio. Rol de entidad de seguridad de base de datos. name: Necesario. Nombre principal de la base de datos. type: Obligatorio. Tipo de entidad de seguridad de base de datos. fqn: nombre completo de la entidad de seguridad de base de datos. correo electrónico: correo electrónico de entidad de seguridad de base de datos si existe. app-id: id. de aplicación: solo relevante para el tipo de entidad de seguridad de la aplicación.

Se pueden especificar varias acciones mediante más de un argumento --value.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database show

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Devuelve una base de datos.

az kusto database show [--cluster-name]
                       [--database-name]
                       [--ids]
                       [--resource-group]
                       [--subscription]

Ejemplos

KustoDatabasesGet

az kusto database show --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest"

Parámetros opcionales

--cluster-name

Nombre del clúster de Kusto.

--database-name

Nombre de la base de datos en el clúster de Kusto.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database update

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Novedades una base de datos.

az kusto database update [--cluster-name]
                         [--database-name]
                         [--ids]
                         [--no-wait]
                         [--read-only-following-database]
                         [--read-write-database]
                         [--resource-group]
                         [--subscription]

Ejemplos

Kusto ReadWrite database create or update

az kusto database update --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --read-write-database location="westus" soft-delete-period="P1D" --resource-group "kustorptest"

Parámetros opcionales

--cluster-name

Nombre del clúster de Kusto.

--database-name

Nombre de la base de datos en el clúster de Kusto.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--read-only-following-database

Clase que representa una base de datos de solo lectura siguiente.

Uso: --read-only-following-database hot-cache-period=XX location=XX kind=XX

período de caché activa: el tiempo en que los datos se deben mantener en caché para consultas rápidas en TimeSpan. location: ubicación del recurso. kind: Obligatorio. Tipo de base de datos.

--read-write-database

Clase que representa una base de datos de escritura de lectura.

Uso: --read-write-database soft-delete-period=XX hot-cache-period=XX location=XX kind=XX

soft-delete-period: el tiempo que deben conservarse los datos antes de dejar de ser accesibles para las consultas en TimeSpan. período de caché activa: el tiempo en que los datos se deben mantener en caché para consultas rápidas en TimeSpan. location: ubicación del recurso. kind: Obligatorio. Tipo de base de datos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az kusto database wait

Habilitación de características

El grupo de comandos "kusto" es experimental y está en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Coloque la CLI en un estado de espera hasta que se cumpla una condición de la base de datos kusto.

az kusto database wait [--cluster-name]
                       [--created]
                       [--custom]
                       [--database-name]
                       [--deleted]
                       [--exists]
                       [--ids]
                       [--interval]
                       [--resource-group]
                       [--subscription]
                       [--timeout]
                       [--updated]

Ejemplos

Pause la ejecución de la siguiente línea de script de la CLI hasta que la base de datos kusto se cree correctamente.

az kusto database wait --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest" --created

Pause la ejecución de la siguiente línea de script de la CLI hasta que la base de datos kusto se actualice correctamente.

az kusto database wait --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest" --updated

Pause la ejecución de la siguiente línea de script de la CLI hasta que la base de datos kusto se elimine correctamente.

az kusto database wait --cluster-name "kustoclusterrptest4" --database-name "KustoDatabase8" --resource-group "kustorptest" --deleted

Parámetros opcionales

--cluster-name

Nombre del clúster de Kusto.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--database-name

Nombre de la base de datos en el clúster de Kusto.

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.