Grupo de comandos catalogs

O catalogs grupo de comandos dentro da CLI do Databricks permite que você gerencie catálogos no Catálogo do Unity. Um catálogo é a primeira camada do namespace de três níveis do Catálogo do Unity. Ele é usado para organizar seus ativos de dados. Veja O que é o Catálogo do Unity?.

criação de catálogos no Databricks

Crie uma nova instância de catálogo no metastore pai se o usuário solicitante for um administrador do metastore ou tiver o privilégio CREATE_CATALOG.

databricks catalogs create NAME [flags]

Arguments

NAME

    Nome do catálogo

Opções

--comment string

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

--connection-name string

    O nome da conexão com uma fonte de dados externa

--json JSON

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

--provider-name string

    O nome do provedor de compartilhamento "Delta"

--share-name string

    O nome do compartilhamento sob o provedor de compartilhamento

--storage-root string

    URL raiz de armazenamento para tabelas gerenciadas no catálogo

Sinalizadores globais

Examples

O exemplo a seguir cria um catálogo chamado sales:

databricks catalogs create sales

O exemplo a seguir cria um catálogo com um comentário:

databricks catalogs create sales --comment "Sales data catalog"

excluir catálogos do Databricks

Exclua o catálogo que corresponde ao nome fornecido. O chamador deve ser um administrador metastore ou o proprietário do catálogo.

databricks catalogs delete NAME [flags]

Arguments

NAME

    O nome do catálogo

Opções

--force

    Forçar a exclusão mesmo se o catálogo não estiver vazio

Sinalizadores globais

Examples

O exemplo a seguir exclui um catálogo chamado sales:

databricks catalogs delete sales

O exemplo a seguir força a exclusão de um catálogo não vazio:

databricks catalogs delete sales --force

Obter catálogos do Databricks

Obtenha o catálogo especificado em um metastore. O chamador deve ser um administrador metastore, o proprietário do catálogo ou um usuário que tenha o USE_CATALOG privilégio definido para sua conta.

databricks catalogs get NAME [flags]

Arguments

NAME

    O nome do catálogo

Opções

--include-browse

    Indica se deve incluir na resposta os catálogos para os 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 catálogo chamado sales:

databricks catalogs get sales

O seguinte exemplo obtém informações do catálogo, incluindo catálogos apenas para navegação:

databricks catalogs get sales --include-browse

lista de catálogos do Databricks

Liste catálogos no metastore. Se o chamador for o administrador do metastore, todos os catálogos serão recuperados. Caso contrário, somente os catálogos pertencentes ao chamador (ou para os quais o chamador tem o USE_CATALOG privilégio) serão recuperados. Não há garantia de uma ordenação específica dos elementos na matriz.

databricks catalogs list [flags]

Opções

--include-browse

    Indica se deve incluir na resposta os catálogos para os quais a entidade de segurança tem acesso apenas a metadados seletivos

--max-results int

    Número máximo de catálogos a serem retornados

--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 catálogos:

databricks catalogs list

O exemplo a seguir lista catálogos com no máximo 10 resultados:

databricks catalogs list --max-results 10

O seguinte exemplo lista catálogos, incluindo catálogos apenas para navegação:

databricks catalogs list --include-browse

atualização de catálogos do Databricks

Atualize o catálogo que corresponde ao nome fornecido. O chamador deve ser o proprietário do catálogo ou um administrador do metastore (ao alterar o campo de proprietário do catálogo).

databricks catalogs update NAME [flags]

Arguments

NAME

    O nome do catálogo

Opções

--comment string

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

--enable-predictive-optimization EnablePredictiveOptimization

    Se a otimização preditiva deve ser habilitada para esse objeto e objetos sob ele. Valores com suporte: DISABLE, ENABLE, INHERIT

--isolation-mode CatalogIsolationMode

    Se o protegível atual é acessível a partir de todos os workspaces ou de um conjunto específico de workspaces. Valores com suporte: ISOLATED, 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 o catálogo

--owner string

    Nome de usuário do proprietário atual do catálogo

Sinalizadores globais

Examples

O exemplo a seguir atualiza o comentário de um catálogo:

databricks catalogs update sales --comment "Updated sales data catalog"

O exemplo a seguir renomeia um catálogo:

databricks catalogs update sales --new-name sales-prod

O exemplo a seguir altera o proprietário de um catálogo:

databricks catalogs update sales --owner someone@example.com

O exemplo a seguir habilita a otimização preditiva para um catálogo:

databricks catalogs update sales --enable-predictive-optimization ENABLE

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 do comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg para usar na execução do comando. Se esse sinalizador não for especificado, 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