Gerenciamento de segredos

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.