Nota
L'accés a aquesta pàgina requereix autorització. Podeu provar d'iniciar la sessió o de canviar els directoris.
L'accés a aquesta pàgina requereix autorització. Podeu provar de canviar els directoris.
Grupo de comandos
Note
Esta información se aplica a las versiones 0.205 y posteriores de la CLI de Databricks. La CLI de Databricks está en versión preliminar pública.
El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.
El warehouses grupo de comandos de la CLI de Databricks permite administrar almacenes de SQL. Una instancia de SQL Warehouse es un recurso de proceso que permite ejecutar comandos SQL en objetos de datos dentro de Databricks SQL. Consulte Conexión al almacén SQL.
Creación de almacenes de databricks
Cree un nuevo almacén de datos SQL.
databricks warehouses create [flags]
Arguments
None
Options
--auto-stop-mins int
Cantidad de tiempo en minutos que un almacén de datos SQL debe permanecer sin actividad (es decir, sin consultas de RUNNING) antes de que se detenga automáticamente.
--cluster-size string
Tamaño de los clústeres asignados para este almacenamiento.
--creator-name string
Nombre del creador del almacén.
--enable-photon
Configura si el almacenamiento debe usar clústeres optimizados para Photon.
--enable-serverless-compute
Configura si el almacén de datos debe usar computación sin servidor.
--instance-profile-arn string
Deprecated.
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
--max-num-clusters int
Número máximo de clústeres que el escalador automático creará para controlar las consultas simultáneas.
--min-num-clusters int
Número mínimo de clústeres disponibles que se mantendrán para este almacenamiento de SQL.
--name string
Nombre lógico del clúster.
--no-wait
No espere a alcanzar el estado RUNNING
--spot-instance-policy SpotInstancePolicy
Configura si el almacén de datos debe usar instancias puntuales. Valores admitidos: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED.
--timeout duration
Cantidad máxima de tiempo para alcanzar RUNNING el estado (valor predeterminado de 20 ms)
--warehouse-type CreateWarehouseRequestWarehouseType
Tipo de almacenamiento: PRO o CLÁSICO. Valores admitidos: CLASSIC, PRO, TYPE_UNSPECIFIED.
Examples
En el ejemplo siguiente se crea una instancia de SQL Warehouse con configuración básica:
databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60
En el ejemplo siguiente se crea un almacén sin servidor con Photon habilitado:
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
databricks warehouses create-default-warehouse-override
Cree una invalidación de almacenamiento predeterminada para un usuario. Los usuarios pueden crear su propia invalidación. Los administradores pueden crear invalidaciones para cualquier usuario.
databricks warehouses create-default-warehouse-override DEFAULT_WAREHOUSE_OVERRIDE_ID TYPE [flags]
Arguments
DEFAULT_WAREHOUSE_OVERRIDE_ID
Identificador de la invalidación. Use un identificador de usuario numérico o la cadena me literal para el usuario actual.
TYPE
Tipo de comportamiento de invalidación. Valores admitidos: CUSTOM, LAST_SELECTED.
Options
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
--name string
Nombre de recurso de la invalidación de almacenamiento predeterminada.
--warehouse-id string
Identificador de almacenamiento específico cuando el tipo es CUSTOM.
Examples
En el ejemplo siguiente se crea una invalidación de almacenamiento personalizada para el usuario actual:
databricks warehouses create-default-warehouse-override me CUSTOM --warehouse-id 1234567890abcdef
eliminar almacenes de Databricks
Elimine un almacén de SQL.
databricks warehouses delete ID [flags]
Arguments
ID
Required. Identificador de SQL Warehouse.
Options
Examples
En el ejemplo siguiente se elimina un almacén con el identificador especificado:
databricks warehouses delete 1234567890abcdef
databricks warehouses delete-default-warehouse-override
Elimine la invalidación de almacenamiento predeterminada para un usuario. Los usuarios pueden eliminar su propia invalidación. Los administradores pueden eliminar invalidaciones para cualquier usuario. Después de la eliminación, se usa el almacenamiento predeterminado del área de trabajo.
databricks warehouses delete-default-warehouse-override NAME [flags]
Arguments
NAME
Nombre de recurso de la invalidación de almacenamiento predeterminada que se va a eliminar. Formato: default-warehouse-overrides/{default_warehouse_override_id}. El identificador puede ser un identificador de usuario numérico o la cadena me literal para el usuario actual.
Options
Examples
En el ejemplo siguiente se elimina la invalidación de almacenamiento predeterminada para el usuario actual:
databricks warehouses delete-default-warehouse-override default-warehouse-overrides/me
Edición de almacenes de datos de Databricks
Actualizar un almacén. Actualiza la configuración de una instancia de SQL Warehouse.
databricks warehouses edit ID [flags]
Arguments
ID
Required. Identificador del almacén que desea configurar.
Options
--auto-stop-mins int
Cantidad de tiempo en minutos que un almacén de datos SQL debe permanecer sin actividad (es decir, sin consultas de RUNNING) antes de que se detenga automáticamente.
--cluster-size string
Tamaño de los clústeres asignados para este almacenamiento.
--creator-name string
Nombre del creador del almacén.
--enable-photon
Configura si el almacenamiento debe usar clústeres optimizados para Photon.
--enable-serverless-compute
Configura si el almacén de datos debe usar computación sin servidor.
--instance-profile-arn string
Deprecated.
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
--max-num-clusters int
Número máximo de clústeres que el escalador automático creará para controlar las consultas simultáneas.
--min-num-clusters int
Número mínimo de clústeres disponibles que se mantendrán para este almacenamiento de SQL.
--name string
Nombre lógico del clúster.
--no-wait
No espere a alcanzar el estado RUNNING
--spot-instance-policy SpotInstancePolicy
Configura si el almacén de datos debe usar instancias puntuales. Valores admitidos: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED.
--timeout duration
Cantidad máxima de tiempo para alcanzar RUNNING el estado (valor predeterminado de 20 ms)
--warehouse-type EditWarehouseRequestWarehouseType
Tipo de almacenamiento. Valores admitidos: CLASSIC, PRO, TYPE_UNSPECIFIED.
Examples
En el ejemplo siguiente se actualiza un almacén para cambiar el tamaño del clúster y el tiempo de detención automática:
databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30
En el ejemplo siguiente se habilita Photon para un almacén existente:
databricks warehouses edit 1234567890abcdef --enable-photon
Acceso a almacenes de Databricks
Obtenga la información de un único almacenamiento de SQL.
databricks warehouses get ID [flags]
Arguments
ID
Required. Identificador de SQL Warehouse.
Options
Examples
En el ejemplo siguiente se obtiene información sobre un almacén con el identificador especificado:
databricks warehouses get 1234567890abcdef
databricks warehouses get-default-warehouse-override
Obtenga la invalidación de almacenamiento predeterminada para un usuario. Los usuarios pueden capturar su propia invalidación. Los administradores pueden capturar invalidaciones para cualquier usuario. Si no existe ninguna invalidación, se usa el almacenamiento predeterminado del área de trabajo.
databricks warehouses get-default-warehouse-override NAME [flags]
Arguments
NAME
Nombre de recurso de la invalidación de almacenamiento predeterminada que se va a recuperar. Formato: default-warehouse-overrides/{default_warehouse_override_id}. El identificador puede ser un identificador de usuario numérico o la cadena me literal para el usuario actual.
Options
Examples
En el ejemplo siguiente se obtiene la invalidación de almacenamiento predeterminada para el usuario actual:
databricks warehouses get-default-warehouse-override default-warehouse-overrides/me
almacenes de Databricks configuración-almacén-espacio-de-trabajo
Obtenga la configuración de nivel de área de trabajo compartida por todos los almacenes de SQL de un área de trabajo.
databricks warehouses get-workspace-warehouse-config [flags]
Arguments
None
Options
Examples
En el ejemplo siguiente se obtiene la configuración del almacén del área de trabajo:
databricks warehouses get-workspace-warehouse-config
lista de almacenes de Databricks
Enumere todos los almacenes de SQL en los que un usuario tiene permisos de administración.
databricks warehouses list [flags]
Arguments
None
Options
--run-as-user-id int
Principal de servicio que se utilizará para obtener la lista de almacenes.
Examples
En el ejemplo siguiente se enumeran todos los almacenes:
databricks warehouses list
En el ejemplo siguiente se enumeran los almacenes que usan una entidad de servicio específica:
databricks warehouses list --run-as-user-id 123456789
databricks warehouses list-default-warehouse-overrides
Enumere todas las invalidaciones de almacenamiento predeterminadas en el área de trabajo. Solo los administradores del área de trabajo pueden enumerar todas las invalidaciones.
databricks warehouses list-default-warehouse-overrides [flags]
Options
--page-size int
Número máximo de invalidaciones que se van a devolver.
--page-token string
Token de página recibido de una llamada anterior list-default-warehouse-overrides .
Examples
En el ejemplo siguiente se enumeran todas las invalidaciones de almacenamiento predeterminadas:
databricks warehouses list-default-warehouse-overrides
Configuración del almacén en Databricks: warehouses set-workspace-warehouse-config
Establezca la configuración de nivel de área de trabajo compartida por todos los almacenes de SQL de un área de trabajo.
databricks warehouses set-workspace-warehouse-config [flags]
Arguments
None
Options
--google-service-account string
Solo GCP: cuenta de servicio de Google usada para pasar al clúster para acceder a Google Cloud Storage.
--instance-profile-arn string
Solo para AWS: perfil de instancia utilizado para asignar el rol de IAM al clúster.
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy
Directiva de seguridad para almacenes. Valores admitidos: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH.
Examples
En el ejemplo siguiente se establece la configuración del almacenamiento del área de trabajo con una directiva de seguridad:
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
Puesta en marcha de los almacenes de Databricks
Inicie un almacén de SQL.
databricks warehouses start ID [flags]
Arguments
ID
Required. Identificador de SQL Warehouse.
Options
--no-wait
No espere a alcanzar el estado RUNNING
--timeout duration
Cantidad máxima de tiempo para alcanzar RUNNING el estado (valor predeterminado de 20 ms)
Examples
En el ejemplo siguiente se inicia un almacén con el identificador especificado:
databricks warehouses start 1234567890abcdef
En el ejemplo siguiente se inicia un almacén sin esperar a que llegue al estado RUNNING:
databricks warehouses start 1234567890abcdef --no-wait
Parada de almacenes de Databricks
Detenga el almacén de datos SQL.
databricks warehouses stop ID [flags]
Arguments
ID
Required. Identificador de SQL Warehouse.
Options
--no-wait
No espere a alcanzar el estado STOPPED
--timeout duration
Cantidad máxima de tiempo para alcanzar STOPPED el estado (valor predeterminado de 20 ms)
Examples
En el ejemplo siguiente se detiene un almacén con el identificador especificado:
databricks warehouses stop 1234567890abcdef
En el siguiente ejemplo se detiene un almacén sin esperar a que alcance el estado STOPPED:
databricks warehouses stop 1234567890abcdef --no-wait
databricks warehouses update-default-warehouse-override
Actualice una invalidación de almacenamiento predeterminada existente para un usuario. Los usuarios pueden actualizar su propia invalidación. Los administradores pueden actualizar invalidaciones para cualquier usuario.
databricks warehouses update-default-warehouse-override NAME UPDATE_MASK TYPE [flags]
Arguments
NAME
Nombre de recurso de la invalidación de almacenamiento predeterminada. Formato: default-warehouse-overrides/{default_warehouse_override_id}.
UPDATE_MASK
Máscara de campo que especifica qué campos se van a actualizar. Use * para actualizar todos los campos. Cuando --allow-missing se establece, este campo se omite y se aplican todos los campos.
TYPE
Tipo de comportamiento de invalidación. Valores admitidos: CUSTOM, LAST_SELECTED.
Options
--allow-missing
Si no se encuentra establecido y no se encuentra la invalidación, cree una nueva invalidación en su lugar.
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
--name string
Nombre de recurso de la invalidación de almacenamiento predeterminada.
--warehouse-id string
Identificador de almacenamiento específico cuando el tipo es CUSTOM.
Examples
En el ejemplo siguiente se actualiza la invalidación del usuario actual en un almacén específico:
databricks warehouses update-default-warehouse-override default-warehouse-overrides/me warehouse_id CUSTOM --warehouse-id 1234567890abcdef
databricks warehouses obtener-niveles-de-permisos
Obtenga los niveles de permisos de SQL Warehouse.
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
El almacén SQL para el que se van a obtener o administrar permisos.
Options
Examples
En el ejemplo siguiente se obtienen los niveles de permisos de un almacén:
databricks warehouses get-permission-levels 1234567890abcdef
databricks almacenes obtener permisos
Obtenga los permisos de un almacén de datos SQL. Los almacenes de SQL pueden heredar permisos de su objeto raíz.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
El almacén SQL para el que se van a obtener o administrar permisos.
Options
Examples
En el ejemplo siguiente se obtienen los permisos de un almacén:
databricks warehouses get-permissions 1234567890abcdef
configurar-permisos de almacenes en Databricks
Establezca permisos de SQL Warehouse. Establece los permisos en un objeto, reemplazando los permisos existentes si existen. Elimina todos los permisos directos si no se especifica ninguno. Los objetos pueden heredar permisos de su objeto raíz.
databricks warehouses set-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
El almacén SQL para el que se van a obtener o administrar permisos.
Options
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
Examples
En el ejemplo siguiente se establecen permisos para un almacenamiento mediante un archivo JSON:
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
databricks warehouses actualizar-permisos
Actualice los permisos en una instancia de SQL Warehouse. Los almacenes de SQL pueden heredar permisos de su objeto raíz.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
El almacén SQL para el que se van a obtener o administrar permisos.
Options
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
Examples
En el ejemplo siguiente se actualizan los permisos de un almacenamiento mediante un archivo JSON:
databricks warehouses update-permissions 1234567890abcdef --json @permissions.json
Marcas globales
--debug
Indica si se va a habilitar el registro de depuración.
-h o --help
Mostrar ayuda para la CLI de Databricks o el grupo de comandos relacionado o el comando relacionado.
--log-file cadena
Cadena que representa el archivo en el que se van a escribir registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr.
--log-format formato
Tipo de formato de registro: text o json. El valor predeterminado es text.
--log-level cadena
Cadena que representa el nivel de formato de registro. Si no se especifica, el nivel de formato de registro está deshabilitado.
-o, --output tipo
El tipo de salida del comando, ya sea text o json. El valor predeterminado es text.
-p, --profile cadena
Nombre del perfil en el archivo ~/.databrickscfg para usarlo al ejecutar el comando. Si no se especifica esta marca, si existe, se usa el perfil denominado DEFAULT .
--progress-format formato
Formato para mostrar los registros de progreso: default, append, inplaceo json
-t, --target cadena
Si es aplicable, el objetivo del paquete que se va a usar