catalogs grupo de comando
Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.
Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.
O grupo de comandos catalogs dentro do Databricks CLI permite gerenciar catálogos no Unity Catalog. Um catálogo é a primeira camada do namespace de três níveis do Unity Catalog. É utilizado para organizar os seus dados ativos. Consulte O que é um Unity Catalog?
catálogos de databricks criados
Crie uma nova instância de catálogo na metastore principal se o chamador for administrador da metastore ou tiver o privilégio CREATE_CATALOG.
databricks catalogs create NAME [flags]
Argumentos
NAME
Nome do catálogo
Opções
--comment string
Descrição de texto em formato livre fornecida pelo usuário
--connection-name string
O nome da conexão com uma fonte de dados externa.
--json JSON
As strings JSON 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 da ação sob o provedor de ações
--storage-root string
URL raiz de armazenamento para tabelas gerenciar dentro do catálogo
Exemplos
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"
catálogos de databricks excluir
Exclua o catálogo que corresponde ao nome fornecido. O chamador deve ser um administrador da metastore ou o proprietário do catálogo.
databricks catalogs delete NAME [flags]
Argumentos
NAME
O nome do catálogo
Opções
--force
Forçar a exclusão mesmo que o catálogo não esteja vazio
Exemplos
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
catálogos de databricks obtêm
Obtenha o catálogo especificado em uma metastore. O autor da chamada deve ser um administrador do metastore, o proprietário do catálogo ou um usuário que tenha o privilégio USE_CATALOG definido para seu account.
databricks catalogs get NAME [flags]
Argumentos
NAME
O nome do catálogo
Opções
--include-browse
Se deve incluir catálogos na resposta para os quais o diretor só pode acessar metadados seletivos
Exemplos
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 do catálogo, incluindo catálogos somente para navegação:
databricks catalogs get sales --include-browse
lista de catálogos de databricks
Liste os catálogos na metastore. Se o chamador for o administrador da metastore, todos os catálogos serão recuperados. Caso contrário, somente os catálogos pertencentes ao chamador (ou para os quais o chamador tenha o privilégio USE_CATALOG) serão recuperados. Não há garantia de uma ordem específica dos elementos na matriz.
databricks catalogs list [flags]
Opções
--include-browse
Se deve incluir catálogos na resposta para os quais o diretor só pode acessar metadados seletivos
--max-results int
Número máximo de catálogos a serem devolvidos
--page-token string
Tokens de paginação opacos para avançar para a próxima página com base na consulta anterior
Exemplos
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 exemplo a seguir lista catálogos, incluindo catálogos somente para navegação:
databricks catalogs list --include-browse
atualização de catálogos de databricks
Atualize o catálogo que corresponde ao nome fornecido. O chamador deve ser o proprietário do catálogo ou um administrador da metastore (ao alterar o campo proprietário do catálogo).
databricks catalogs update NAME [flags]
Argumentos
NAME
O nome do catálogo
Opções
--comment string
Descrição de texto em formato livre fornecida pelo usuário
--enable-predictive-optimization EnablePredictiveOptimization
Se a otimização preditiva deve ser habilitada para esse objeto e os objetos abaixo dele. Valores suportados: DISABLE, ENABLE, INHERIT
--isolation-mode CatalogIsolationMode
Se o recurso protegido atual está acessível a partir de todo o espaço de trabalho ou de um conjunto específico de espaços de trabalho. Valores suportados: ISOLATED, OPEN
--json JSON
As strings JSON 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 atual proprietário do catálogo
Exemplos
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 de um catálogo:
databricks catalogs update sales --enable-predictive-optimization ENABLE
Bandeiras globais
--debug
Se deve habilitar o registro de depuração.
-h ou --help
Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.
--log-file string
Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.
--log-format Formato
O tipo de formato do log, text ou json. O valor de default é text.
--log-level string
Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.
-o, --output Tipo
O tipo de saída do comando, text ou json. O valor de default é text.
-p, --profile string
O nome do perfil no arquivo ~/.databrickscfg a ser utilizado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil chamado DEFAULT será usado.
--progress-format Formato
O formato para exibir o progresso logs: default, append, inplace ou json
-t, --target string
Se aplicável, o destino do pacote a ser usado