rfa grupo de comandos
Esta informação aplica-se às versões 0.205 e acima Databricks CLI . A CLI do Databricks está em versão prévia pública.
O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.
O grupo de comandos rfa (Solicitação de Acesso) dentro da CLIDatabricks contém comandos que permitem aos usuários solicitar acesso a itens protegíveis do Unity Catalog . Esses comandos fornecem uma maneira padronizada para proprietários protegidos (ou usuários com privilégios de gerenciamento) gerenciarem destinos de solicitações de acesso.
databricks rfa lotes-create-access-requests
Crie solicitações de acesso para permissões do Unity Catalog para uma entidade específica em um objeto protegível. Esta API de lotes pode receber como entrada múltiplos principais, objetos protegíveis e permissões, retornando os destinos das solicitações de acesso para cada um. Os valores principais devem ser únicos em toda a chamada da API.
Os tipos protegidos suportados são: metastore, catalog, schema, table, external_location, connection, credential, function, registered_model e volume.
databricks rfa batch-create-access-requests [flags]
Opções
--json JSON
As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.
Exemplos
O exemplo a seguir cria várias solicitações de acesso usando JSON:
databricks rfa batch-create-access-requests --json '{"requests": [{"principal": "user@example.com", "securable_type": "catalog", "securable_full_name": "my_catalog", "permissions": ["USE_CATALOG", "USE_SCHEMA"]}]}'
O exemplo a seguir cria solicitações de acesso usando um arquivo JSON:
databricks rfa batch-create-access-requests --json @access-requests.json
databricks rfa get-access-request-destinations
Obtenha os destinos das solicitações de acesso para o objeto protegido especificado. Qualquer pessoa que faça a chamada pode ver os destinos da URL ou os destinos no metastore. Caso contrário, somente aqueles com permissões de NAVEGAÇÃO no arquivo protegido poderão ver os destinos.
Os tipos protegidos suportados são: metastore, catalog, schema, table, external_location, connection, credential, function, registered_model e volume.
databricks rfa get-access-request-destinations SECURABLE_TYPE FULL_NAME [flags]
Argumentos
SECURABLE_TYPE
O tipo de objeto protegível.
FULL_NAME
O nome completo do bem garantido.
Opções
Exemplos
O exemplo a seguir obtém os destinos das solicitações de acesso para um catálogo:
databricks rfa get-access-request-destinations catalog my_catalog
O exemplo a seguir obtém os destinos das solicitações de acesso para uma tabela:
databricks rfa get-access-request-destinations table my_catalog.my_schema.my_table
databricks rfa update-access-request-destinations
Atualize os destinos das solicitações de acesso para o item protegido especificado. O chamador deve ser um administrador do metastore, o proprietário do objeto protegível ou um usuário que tenha o privilégio de gerenciar o objeto protegível para poder atribuir destinos.
Não é possível atualizar os destinos para itens protegíveis que estejam dentro de esquemas (tabelas, volumes, funções e modelos). Para esses tipos protegíveis, os destinos são herdados do objeto protegível pai. É possível atribuir no máximo 5 destinos de e-mail e 5 destinos de notificação externa (Slack, Microsoft Teams e destinos de Webhook genéricos) a um objeto protegido. Se um destino de URL for atribuído, nenhum outro destino poderá ser definido.
Os tipos protegidos suportados são: metastore, catalog, schema, table, external_location, connection, credential, function, registered_model e volume.
databricks rfa update-access-request-destinations UPDATE_MASK SECURABLE [flags]
Argumentos
UPDATE_MASK
A máscara de campo deve ser uma única string, com múltiplos campos separados por vírgulas (sem espaços). O caminho do campo é relativo ao objeto de recurso, usando um ponto (.) para navegar pelos subcampos (por exemplo, author.given_name). A especificação de elementos em campos de sequência ou mapa não é permitida, pois somente o campo de coleção inteiro pode ser especificado. Os nomes dos campos devem corresponder exatamente aos nomes dos campos de recurso.
Um asterisco (*) no campo indica substituição completa. É recomendável sempre listar explicitamente os campos que estão sendo atualizados e evitar o uso de curingas, pois isso pode levar a resultados inesperados caso a API seja alterada no futuro.
SECURABLE
O objeto protegível para o qual os destinos das solicitações de acesso estão sendo modificados ou lidos.
Opções
--json JSON
As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.
Exemplos
O exemplo a seguir atualiza os destinos de solicitação de acesso para um catálogo usando JSON:
databricks rfa update-access-request-destinations "destinations" catalog:my_catalog --json '{"destinations": [{"email": "admin@example.com"}]}'
O exemplo a seguir atualiza os destinos de solicitação de acesso usando um arquivo JSON:
databricks rfa update-access-request-destinations "destinations" catalog:my_catalog --json @destinations.json
Bandeiras globais
--debug
Ativar ou não o registro de depuração.
-h ou --help
Exibir ajuda para a CLI Databricks , o grupo de comandos relacionado ou o comando específico.
--log-file string
Uma sequência de caracteres representando o arquivo no qual logs de saída serão gravados. Se essa opção não for especificada, o default é gravar logs de saída em stderr.
--log-format Formato
O tipo de formato de log, text ou json. O valor default é text.
--log-level string
Uma sequência de caracteres representando o nível de formato log . Caso não seja especificado, o nível de formato log será desativado.
-o, --output Tipo
O tipo de saída do comando, text ou json. O valor default é text.
-p, --profile string
O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, então, se existir, o perfil denominado 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 pacote de destino a ser usado.