external-locations grupo de comando

O external-locations grupo de comandos dentro do CLI Databricks contém comandos para criar e gerir localizações externas para o Unity Catalog. Consulte Quais são os volumes do Catálogo Unity?.

Criação de locais externos do Databricks

Crie uma nova entrada de local externo no metastore. O chamador deve ser um administrador de 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 do caminho do local externo.

CREDENTIAL_NAME

    Nome da credencial de armazenamento usada com esse local.

Opções

--comment string

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

--enable-file-events

    Se os eventos de arquivo devem ser habilitados nesse local externo.

--fallback

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

--json JSON

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

--read-only

    Indica se a localização externa é de leitura única.

--skip-validation

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

Bandeiras 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 seguinte cria uma localização externa de leitura única:

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

Databricks External-Locations Excluir

Exclua o local externo especificado do metastore. 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

    Força a eliminação mesmo se houver tabelas ou montagens externas dependentes.

Bandeiras 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 obter localizações externas

Obtenha um local externo do metastore. O chamador deve ser um administrador de 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

    Se deve incluir locais externos na resposta, para os quais o principal só tem acesso a metadados seletivos.

Bandeiras 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 a partir do metastore. O chamador deve ser um administrador de 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

    Se deve incluir locais externos na resposta, para os quais o principal só tem acesso a metadados seletivos.

--include-unbound

    Se deve incluir locais externos não vinculados ao espaço de trabalho.

--max-results int

    Número máximo de locais externos que devem ser devolvidos.

--page-token string

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

Bandeiras 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 de 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 de texto de forma livre fornecida pelo usuário.

--credential-name string

    Nome da credencial de armazenamento usada com esse local.

--enable-file-events

    Se os eventos de arquivo devem ser habilitados nesse local externo.

--fallback

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

--force

    Forçar a atualização mesmo se a alteração de url invalidar tabelas ou montagens externas dependentes.

--isolation-mode IsolationMode

    Valores suportados: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

    A cadeia de caracteres JSON embutida 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 a localização externa é de leitura única.

--skip-validation

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

--url string

    URL do caminho do local externo.

Bandeiras 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

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

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

--log-file String

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text ou json. O valor predefinido é text.

--log-level String

    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á desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile String

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

--progress-format Formato

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

-t, --target String

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