Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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
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
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
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
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
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