Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Um segredo do Azure Databricks armazena um valor sensível, como uma senha, chave de API ou sal de hash, para que notebooks, jobs e funções possam usá-lo sem que o valor apareça no código. Você pode gerenciar segredos em dois lugares:
- Escopos secretos de espaço de trabalho: Coleções nomeadas de segredos em um único espaço de trabalho. Permissões se aplicam a todo o escopo. Veja Escopos secretos do espaço de trabalho.
-
Secrets in Unity Catalog: Objetos protegíveis (
catalog.schema.secret) que estão disponíveis em todos os espaços de trabalho conectados à metastore. Você pode conceder acesso a cada segredo. Consulte Segredos no Catálogo do Unity.
Os segredos do Unity Catalog podem ser gerenciados pelo Azure Databricks ou ter suporte do Azure Key Vault. Veja os segredos do Azure Key Vault no Unity Catalog.
Escolha onde armazenar um segredo
A tabela a seguir compara onde cada opção armazena valores secretos, quais espaços de trabalho podem usá-los e como você controla o acesso.
| Escopo secreto do espaço de trabalho | segredo gerenciado pelo Azure Databricks no Unity Catalog | Segredo respaldado por Azure Key Vault no Unity Catalog (Beta) | |
|---|---|---|---|
| Onde o valor é armazenado | Azure Databricks, no espaço de trabalho, ou seu Azure Key Vault com um escopo respaldado pelo Key Vault | Azure Databricks, no Unity Catalog | Azure Key Vault (Azure Databricks armazena apenas o nome do segredo no Unity Catalog) |
| Criptografia com sua própria chave | Sim, com uma chave gerenciada pelo cliente para serviços gerenciados | Sim, com uma chave gerenciada pelo cliente no catálogo | |
| Disponível em | Um espaço de trabalho | Todo espaço de trabalho vinculado ao metastore | Cada espaço de trabalho anexado à metastore |
| Controle de acesso | Permissões para o escopo de segredos (sem controle de acesso no nível do segredo) | Privilégios do Catálogo Unity no segredo, esquema ou catálogo | Privilégios do Catálogo Unity no secret, esquema ou catálogo |
| Girar | Atualize o valor no Azure Databricks ou no Key Vault para um escopo respaldado pelo Key Vault | Atualize o valor em Azure Databricks | Gire no Azure Key Vault. Nenhuma alteração em Azure Databricks. |
Onde você pode usar segredos
Escopos de segredo do workspace e segredos do Catálogo Unity são suportados em diferentes lugares. Antes de escolher um, verifique se funciona onde seu código roda.
| Surface | Escopo secreto do espaço de trabalho | Segredo no Unity Catalog |
|---|---|---|
dbutils.secrets em notebooks e jobs |
Sim. Veja Leia um segredo. | Sim, em ambientes serverless versão 4 e superiores ou Databricks Runtime 17.3 LTS e superiores. Veja Leia um segredo. |
| API REST e CLI Databricks | Sim. Os valores retornados pela API não são ocultados. | Sim. Os valores retornados pela API não são ocultados. |
| Desenvolvimento remoto, como Databricks Connect | Sim, com dbutils.secrets no cliente do Databricks Connect. Veja Utilitários Databricks com Databricks Connect para Python. |
No |
| Catálogo Unity de UDFs em Python e Scala | No | Sim. Os chamadores precisam apenas de EXECUTE. Veja Usar segredos em UDFs. |
| Armazenamentos SQL | Sim, com a função secreta | Somente por meio de um UDF do Unity Catalog Python ou Scala que declare o segredo |
| Propriedades de configuração do Spark e variáveis de ambiente no compute | Sim. Confira Usar um segredo em uma propriedade de configuração ou variável de ambiente do Spark. | No |
| Variáveis de ambiente do endpoint de serving de modelo | Sim. Consulte Adicionar variáveis de ambiente baseadas em segredos. | No |
| Repositórios padrão de pacotes | Sim, dentro do databricks-package-management escopo. Veja Configurar repositórios de pacotes padrão. |
No |
Recursos adicionais
| Resource | Description |
|---|---|
| Segredos no Unity Catalog | Crie segredos do Unity Catalog, conceda acesso e leia-os em notebooks, jobs e UDFs. |
| Melhores práticas para segredos do Unity Catalog | Organize os segredos por ambiente, aplicação ou equipe, e deixe cargas de trabalho usarem segredos sem que eles os leiam. |