Partilhar via


catalogs grupo de comando

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

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

Criar catálogos Databricks

Crie uma nova instância de catálogo no metastore pai caso o chamador seja um administrador de metastore ou possua o privilégio CREATE_CATALOG.

databricks catalogs create NAME [flags]

Arguments

NAME

    Nome do catálogo

Opções

--comment string

    Descrição de 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 embutida 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 dentro do catálogo

Bandeiras 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"

Eliminar catálogos do Databricks

Exclua o catálogo que corresponde ao nome fornecido. O chamador deve ser um administrador de 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 que o catálogo não esteja vazio

Bandeiras 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 Databricks

Obtenha o catálogo especificado em um metastore. O chamador deve ser um administrador de 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

    Se os catálogos devem ser incluídos na resposta para os quais o utilizador só pode aceder a metadados seletivos

Bandeiras globais

Examples

O exemplo a seguir obtém informações sobre um catálogo chamado sales:

databricks catalogs get sales

O exemplo a seguir obtém informações de catálogo, incluindo catálogos somente de navegação:

databricks catalogs get sales --include-browse

Lista de catálogos do Databricks

Listar catálogos no metastore. Se o chamador for o administrador do metastore, todos os catálogos serão recuperados. Caso contrário, apenas os catálogos de propriedade do 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

    Se os catálogos devem ser incluídos na resposta para os quais o utilizador só pode aceder a metadados seletivos

--max-results int

    Número máximo de catálogos a devolver

--page-token string

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

Bandeiras globais

Examples

O exemplo a seguir lista todos os catálogos:

databricks catalogs list

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

databricks catalogs list --max-results 10

O exemplo a seguir lista catálogos, incluindo catálogos somente de 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 (quando alterar o campo proprietário do catálogo).

databricks catalogs update NAME [flags]

Arguments

NAME

    O nome do catálogo

Opções

--comment string

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

--enable-predictive-optimization EnablePredictiveOptimization

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

--isolation-mode CatalogIsolationMode

    Se o objeto protegível atual é acessível a partir de todos os espaços de trabalho ou apenas de um conjunto específico deles. Valores suportados: ISOLATED, 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 o catálogo

--owner string

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

Bandeiras 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 permite a otimização preditiva para um catálogo:

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

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