Grupo de comandos external-locations

El external-locations grupo de comandos de la CLI de Databricks contiene comandos para crear y administrar ubicaciones externas para el catálogo de Unity. Consulte ¿Qué son los volúmenes de Unity Catalog?.

creación de ubicaciones externas en Databricks

Cree una nueva entrada de ubicación externa en el metastore. El autor de la llamada debe ser un administrador de metastore o tener el CREATE_EXTERNAL_LOCATION privilegio en el metastore y en la credencial de almacenamiento asociada.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Nombre de la ubicación externa.

URL

    Dirección URL de la ubicación externa.

CREDENTIAL_NAME

    Nombre de la credencial de almacenamiento usada con esta ubicación.

Options

--comment string

    Descripción de texto en formato libre proporcionada por el usuario.

--enable-file-events

    Si se debe habilitar eventos de archivo en esta ubicación externa.

--fallback

    Indica si el modo de respaldo está habilitado para esta ubicación externa.

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--read-only

    Indica si la ubicación externa es de solo lectura.

--skip-validation

    Omite la validación de la credencial de almacenamiento asociada a la ubicación externa.

Marcas globales

Examples

En el ejemplo siguiente se crea una ubicación externa con un comentario:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

En el ejemplo siguiente se crea una ubicación externa de solo lectura:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

eliminación de ubicaciones externas en Databricks

Elimina la ubicación externa especificada del metastore. El autor de la llamada debe ser el propietario de la ubicación externa.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Nombre de la ubicación externa.

Options

--force

    Fuerza la eliminación incluso si hay tablas o montajes externos dependientes.

Marcas globales

Examples

En el ejemplo siguiente se elimina una ubicación externa denominada my-external-location:

databricks external-locations delete my-external-location

En el ejemplo siguiente se elimina de forma forzada una ubicación externa aunque haya dependencias:

databricks external-locations delete my-external-location --force

obtención de ubicaciones externas de databricks

Obtiene una ubicación externa desde el metastore. El autor de la llamada debe ser un administrador de metastore, el propietario de la ubicación externa o un usuario que tenga algún privilegio en la ubicación externa.

databricks external-locations get NAME [flags]

Arguments

NAME

    Nombre de la ubicación externa.

Options

--include-browse

    Si deberían incluirse ubicaciones externas en la respuesta para las cuales el principal solo puede acceder a metadatos selectivos.

Marcas globales

Examples

En el ejemplo siguiente se obtiene información sobre una ubicación externa denominada my-external-location:

databricks external-locations get my-external-location

En el ejemplo siguiente se obtiene información, incluidos los metadatos de exploración:

databricks external-locations get my-external-location --include-browse

lista de ubicaciones externas de databricks

Enumera las ubicaciones externas del metastore. El autor de la llamada debe ser un administrador de metastore, el propietario de la ubicación externa o un usuario que tenga algún privilegio en la ubicación externa. No hay ninguna garantía de una ordenación específica de los elementos de la matriz.

databricks external-locations list [flags]

Options

--include-browse

    Si deberían incluirse ubicaciones externas en la respuesta para las cuales el principal solo puede acceder a metadatos selectivos.

--include-unbound

    Si se deben incluir ubicaciones externas no enlazadas al área de trabajo.

--max-results int

    Número máximo de ubicaciones externas para devolución.

--page-token string

    Token de paginación opaco para ir a la página siguiente en función de la consulta anterior.

Marcas globales

Examples

En el ejemplo siguiente se enumeran todas las ubicaciones externas:

databricks external-locations list

En el ejemplo siguiente se enumeran las ubicaciones externas con un máximo de 10 resultados:

databricks external-locations list --max-results 10

Actualización de ubicaciones externas de Databricks

Actualice una ubicación externa en el metastore. El autor de la llamada debe ser el propietario de la ubicación externa o ser un administrador de metastore. En el segundo caso, el administrador solo puede actualizar el nombre de la ubicación externa.

databricks external-locations update NAME [flags]

Arguments

NAME

    Nombre de la ubicación externa.

Options

--comment string

    Descripción de texto en formato libre proporcionada por el usuario.

--credential-name string

    Nombre de la credencial de almacenamiento usada con esta ubicación.

--enable-file-events

    Si se debe habilitar eventos de archivo en esta ubicación externa.

--fallback

    Indica si el modo de respaldo está habilitado para esta ubicación externa.

--force

    Forzar la actualización incluso si al cambiar la dirección URL se invalidan las tablas externas dependientes o los montajes.

--isolation-mode IsolationMode

    Valores admitidos: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--new-name string

    Nuevo nombre para la ubicación externa.

--owner string

    Propietario de la ubicación externa.

--read-only

    Indica si la ubicación externa es de solo lectura.

--skip-validation

    Omite la validación de la credencial de almacenamiento asociada a la ubicación externa.

--url string

    Dirección URL de la ubicación externa.

Marcas globales

Examples

En el ejemplo siguiente se cambia el nombre de una ubicación externa:

databricks external-locations update my-external-location --new-name my-renamed-location

En el ejemplo siguiente se cambia el propietario de una ubicación externa:

databricks external-locations update my-external-location --owner someone@example.com

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