shares 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 shares dentro do Databricks CLI permite gerenciar compartilhamentos no Unity Catalog.
Um compartilhamento é um contêiner instanciado com shares create. Após a criação, é possível registrar iterativamente uma coleção de dados existentes ativos definidos no metastore utilizando shares update. É possível registrar dados ativos com seus nomes originais, qualificados por seu esquema original, ou fornecer nomes alternativos expostos.
criação de compartilhamentos de databricks
Crie um novo compartilhamento para objetos de dados. Objetos de dados podem ser adicionados após a criação com update. O chamador deve ser administrador da metastore ou ter o privilégio CREATE_SHARE na metastore.
databricks shares create NAME [flags]
Argumentos
NAME
Nome da ação.
Opções
--comment string
Descrição de texto em formato livre fornecida pelo usuário.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--storage-root string
URL raiz de armazenamento para o compartilhamento.
Exemplos
Os exemplos a seguir criam um compartilhamento chamado my-analytics-share com um comentário:
databricks shares create my-analytics-share --comment "Sales analytics data share"
O exemplo a seguir cria um compartilhamento com uma raiz de armazenamento específica:
databricks shares create my-analytics-share --storage-root "s3://my-bucket/share-data"
exclusões de compartilhamentos do databricks
Exclua um compartilhamento da metastore. O chamador deve ser proprietário do compartilhamento.
databricks shares delete NAME [flags]
Argumentos
NAME
O nome da ação.
Opções
Exemplos
O exemplo a seguir exclui um compartilhamento chamado my-analytics-share:
databricks shares delete my-analytics-share
os compartilhamentos do databricks obtêm
Obtenha uma parte da metastore. O chamador deve ser um administrador da metastore ou o proprietário do compartilhamento.
databricks shares get NAME [flags]
Argumentos
NAME
O nome da ação.
Opções
--include-shared-data
Consulte os dados a serem incluídos no compartilhamento.
Exemplos
O exemplo a seguir obtém informações sobre um compartilhamento denominado “ my-analytics-share”:
databricks shares get my-analytics-share
O exemplo a seguir recebe um compartilhamento com detalhes sobre os dados compartilhados:
databricks shares get my-analytics-share --include-shared-data
lista de ações do databricks
Liste os compartilhamentos da metastore. O chamador deve ser um administrador da metastore ou o proprietário do compartilhamento. Não há garantia de uma ordem específica dos elementos na matriz.
databricks shares list [flags]
Argumentos
Nenhuma
Opções
--max-results int
Número máximo de ações a serem devolvidas.
--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 compartilhamentos:
databricks shares list
atualização de compartilhamentos do databricks
Atualize o compartilhamento com as alterações e os objetos de dados na solicitação. O chamador deve ser o proprietário do compartilhamento ou um administrador da metastore.
Quando o chamador é administrador da metastore, somente o campo owner pode ser atualizado.
Caso o nome do compartilhamento seja alterado, updateShare exige que o chamador seja o proprietário do compartilhamento e tenha o privilégio CREATE_SHARE.
Se houver arquivos do Notebook no compartilhamento, o campo “ storage_root ” não poderá ser atualizado.
Para cada tabela adicionada por meio desse método, o proprietário do compartilhamento também deve ter o privilégio SELECT na tabela. Esse privilégio deve ser mantido indefinidamente para que os destinatários possam acessar a tabela. Normalmente, você deve usar um grupo como proprietário do compartilhamento.
As remoções de tabelas por meio de update não exigem privilégios adicionais.
databricks shares update NAME [flags]
Argumentos
NAME
O nome da ação.
Opções
--comment string
Descrição de texto em formato livre fornecida pelo usuário.
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--new-name string
Novo nome para o compartilhamento.
--owner string
Nome de usuário do atual proprietário do compartilhamento.
--storage-root string
URL raiz de armazenamento para o compartilhamento.
Exemplos
O exemplo a seguir atualiza o comentário de um compartilhamento:
databricks shares update my-analytics-share --comment "Updated sales analytics data share"
O exemplo a seguir altera o nome de um compartilhamento:
databricks shares update my-analytics-share --new-name "sales-analytics-share"
O exemplo a seguir atualiza o proprietário de um compartilhamento:
databricks shares update my-analytics-share --owner "someone@example.com"
O exemplo a seguir atualiza um compartilhamento utilizando a configuração JSON:
databricks shares update my-analytics-share --json '{
"comment": "Updated share with new tables",
"objects": [
{
"name": "sales.customers",
"data_object_type": "TABLE"
}
]
}'
databricks compartilha permissões de compartilhamento
Obtenha permissões para um compartilhamento de dados do metastore. O chamador deve ser um administrador da metastore ou o proprietário do compartilhamento.
databricks shares share-permissions NAME [flags]
Argumentos
NAME
O nome da ação.
Opções
--max-results int
Número máximo de permissões para retornar.
--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 obtém permissões para um compartilhamento chamado my-analytics-share:
databricks shares share-permissions my-analytics-share
databricks compartilha permissões de atualização
Atualize as permissões para um compartilhamento de dados no metastore. O chamador deve ser administrador da metastore ou proprietário do compartilhamento.
Para subsídios para novos beneficiários, o usuário também deve ser o proprietário do destinatário ou administrador da metastore. as revogações de destinatários não exigem privilégios adicionais.
databricks shares update-permissions NAME [flags]
Argumentos
NAME
O nome da ação.
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
--omit-permissions-list
Opcional.
Exemplos
O exemplo a seguir concede permissões a um destinatário:
databricks shares update-permissions my-analytics-share --json '{
"changes": [
{
"principal": "recipient-name",
"add": ["SELECT"]
}
]
}'
O exemplo a seguir revoga as permissões de um destinatário:
databricks shares update-permissions my-analytics-share --json '{
"changes": [
{
"principal": "recipient-name",
"remove": ["SELECT"]
}
]
}'
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