Gestione dei segreti

Un segreto di Azure Databricks memorizza un valore sensibile, come una password, una chiave API o hashing salt, così che notebook, job e funzioni possano usarlo senza che il valore appaia nel codice. Puoi gestire i secret in due posizioni:

  • Ambiti dei segreti dell'area di lavoro: Collezioni nominate di segreti in un unico spazio di lavoro. I permessi si applicano all'intero ambito. Vedi ambiti dei segreti dell'area di lavoro.
  • Segreti in Unity Catalog: Oggetti proteggibili (catalog.schema.secret) disponibili in ogni workspace collegato al metastore. Puoi concedere l'accesso a ogni segreto. Consulta Segreti in Unity Catalog.

I segreti di Unity Catalog possono essere gestiti da Azure Databricks o archiviati in Azure Key Vault. Vedi Azure Key Vault secrets nel Catalogo Unity.

Scegli dove conservare un segreto

La tabella seguente confronta dove ogni opzione memorizza i valori segreti, quali workspace possono usarli e come si controlla l'accesso.

  Ambito segreto del workspace Azure Databricks-managed secret in Unity Catalog Segreto con supporto di Azure Key Vault in Unity Catalog (Beta)
Dove il valore è memorizzato Azure Databricks, nello spazio di lavoro, oppure nel tuo Azure Key Vault con uno scope supportato da Azure Key Vault Azure Databricks, in Unity Catalog Azure Key Vault (Azure Databricks memorizza solo il nome del segreto in Unity Catalog)
Crittografia con la tua chiave Sì, con una chiave gestita dal cliente per i servizi gestiti Sì, con una chiave gestita dal cliente nel catalogo
Disponibile in Un'area di lavoro Ogni spazio di lavoro collegato al metastore Ogni spazio di lavoro collegato al metastore
Controllo di accesso Permessi di ambito Secret (nessun controllo di accesso a livello Secret) Privilegi del Catalogo Unity sul segreto, schema o catalogo Privilegi del Catalogo Unity sul segreto, schema o catalogo
Ruotare Aggiorna il valore in Azure Databricks o in Key Vault per un ambito con supporto di Key Vault Aggiornare il valore in Azure Databricks Ruotare in Azure Key Vault. Nessun cambiamento in Azure Databricks.

Dove puoi usare i secret

Gli ambiti dei segreti dello spazio di lavoro e i segreti del catalogo Unity sono supportati in luoghi diversi. Prima di sceglierne uno, verifica che funzioni dove il tuo codice viene eseguito.

Surface Ambito segreto del workspace Segreto in Unity Catalog
dbutils.secrets nei notebook e nei job Yes. Vedi Leggi un segreto. Sì, su ambienti serverless versione 4 e superiori o Databricks Runtime 17.3 LTS e superiori. Vedi Leggi un segreto.
API REST e Databricks CLI Yes. I valori restituiti dall'API non sono oscurati. Yes. I valori restituiti dall'API non sono oscurati.
Sviluppo remoto, come Databricks Connect Sì, con il client Databricks Connect dbutils.secrets. Vedi Databricks Utilities con Databricks Connect for Python. No
Catalogo Unity UDF Python e Scala No Yes. I chiamanti devono solo EXECUTE. Vedi Usa segreti negli UDF.
Magazzini SQL Sì, con la funzione segreta Solo tramite un UDF Unity Catalog Python o Scala che dichiara il segreto
Proprietà di configurazione di Spark e variabili di ambiente nel calcolo Yes. Si veda Usare un segreto in una proprietà di configurazione Spark o in una variabile di ambiente. No
Variabili di ambiente dell'endpoint di serving del modello Yes. Vedere Aggiungere variabili di ambiente basate su segreti. No
Repository predefiniti dei pacchetti Sì, nell'ambito databricks-package-management . Vedi Configura repository di pacchetti predefiniti. No

Risorse aggiuntive

Resource Description
Catalogo Secrets in Unity Crea segreti del Catalogo Unity, concedi l'accesso e leggili in notebook, job e UDF.
Migliori pratiche per i segreti di Unity Catalog Organizza i secret per ambiente, applicazione o team, e lascia che i carichi di lavoro utilizzino i secret senza leggerli.
  • Ultimo aggiornamento: