Grupo de comandos external-locations

O grupo de external-locations comandos dentro do Databricks CLI contém comandos para criar e gerenciar locais externos para o Unity Catalog. Confira O que são volumes do Unity Catalog?.

databricks external-locations criar

Crie uma nova entrada de local externo no metastore. O chamador deve ser um administrador metastore ou ter o CREATE_EXTERNAL_LOCATION privilégio no metastore e na credencial de armazenamento associada.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Nome do local externo.

URL

    URL de caminho do local externo.

CREDENTIAL_NAME

    Nome da credencial de armazenamento usada com esse local.

Opções

--comment string

    Descrição do texto de forma livre fornecida pelo usuário.

--enable-file-events

    Se deseja habilitar eventos de arquivo neste local externo.

--fallback

    Indica se o modo de fallback está habilitado para esse local externo.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--read-only

    Indica se o local externo é somente leitura.

--skip-validation

    Ignora a validação da credencial de armazenamento associada ao local externo.

Sinalizadores globais

Examples

O exemplo a seguir cria um local externo com um comentário:

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

O exemplo a seguir cria um local externo somente leitura:

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

locais-externos databricks delete

Exclua o local externo especificado do repositório de metadados. O chamador deve ser o proprietário do local externo.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Nome do local externo.

Opções

--force

    Force a exclusão mesmo se houver tabelas ou montagens externas dependentes.

Sinalizadores globais

Examples

O exemplo a seguir exclui um local externo chamado my-external-location:

databricks external-locations delete my-external-location

O exemplo a seguir exclui com força um local externo, mesmo que haja dependências:

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

databricks buscar localizações externas

Obtenha uma localização externa do metastore. O chamador deve ser um administrador metastore, o proprietário do local externo ou um usuário que tenha algum privilégio no local externo.

databricks external-locations get NAME [flags]

Arguments

NAME

    Nome do local externo.

Opções

--include-browse

    Indica se deve incluir na resposta as localizações externas para as quais a entidade de segurança tem acesso apenas a metadados seletivos.

Sinalizadores globais

Examples

O exemplo a seguir obtém informações sobre um local externo chamado my-external-location:

databricks external-locations get my-external-location

O exemplo a seguir obtém informações, incluindo metadados de navegação:

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

lista de locais externos do databricks

Liste locais externos do metastore. O chamador deve ser um administrador metastore, o proprietário do local externo ou um usuário que tenha algum privilégio no local externo. Não há garantia de uma ordenação específica dos elementos na matriz.

databricks external-locations list [flags]

Opções

--include-browse

    Indica se deve incluir na resposta as localizações externas para as quais a entidade de segurança tem acesso apenas a metadados seletivos.

--include-unbound

    Se deseja incluir locais externos não associados ao workspace.

--max-results int

    Número máximo de localizações externas que devem ser retornadas.

--page-token string

    Token opaco de paginação para avançar para a próxima página com base na consulta anterior.

Sinalizadores globais

Examples

O exemplo a seguir lista todos os locais externos:

databricks external-locations list

O exemplo a seguir lista locais externos com um máximo de 10 resultados:

databricks external-locations list --max-results 10

Atualização de locais externos do Databricks

Atualize um local externo no metastore. O chamador deve ser o proprietário do local externo ou ser um administrador do metastore. No segundo caso, o administrador só pode atualizar o nome do local externo.

databricks external-locations update NAME [flags]

Arguments

NAME

    Nome do local externo.

Opções

--comment string

    Descrição do texto de forma livre fornecida pelo usuário.

--credential-name string

    Nome da credencial de armazenamento usada com esse local.

--enable-file-events

    Se deseja habilitar eventos de arquivo neste local externo.

--fallback

    Indica se o modo de fallback está habilitado para esse local externo.

--force

    Force a atualização mesmo se a alteração da URL invalidar as montagens ou tabelas externas dependentes.

--isolation-mode IsolationMode

    Valores com suporte: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--new-name string

    Novo nome para a localização externa.

--owner string

    O proprietário do local externo.

--read-only

    Indica se o local externo é somente leitura.

--skip-validation

    Ignora a validação da credencial de armazenamento associada ao local externo.

--url string

    URL de caminho do local externo.

Sinalizadores globais

Examples

O exemplo a seguir renomeia um local externo:

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

O exemplo a seguir altera o proprietário de um local externo:

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

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo para o qual gravar logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desabilitado.

-o, --output tipo

    O tipo de saída de comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se esse sinalizador não for especificado e se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

    O formato para exibir logs de progresso: default, append, inplace ou json

-t, --target corda

    Se aplicável, o destino do pacote a ser usado