Unity Catalog’daki Gizli Bilgiler

Important

Bu özellik Genel Önizleme aşamasındadır.

Bu sayfada Unity Catalog'da gizli anahtarların nasıl oluşturulacağı, okunacağı, yönetişiminin nasıl sağlanacağı ve yönetileceği açıklanmaktadır. Unity Kataloğu gizli dizisi parola, belirteç veya API anahtarı gibi hassas malzemeleri depolayan güvenli hale getirilebilir bir nesnedir. Notebook’larınız ve işleriniz, değeri kodda açığa çıkarmadan gizli anahtara başvurabilir.

Unity Kataloğu gizli dizileri üç düzeyli ad alanını (catalog.schema.secret) kullanır ve meta veri deposuna eklenen çalışma alanlarında kullanılabilir. Bunlar Unity Catalog izinleri tarafından denetlenir. Bu, gizli dizilerinize diğer veri varlıkları için kullandığınız erişim modelini ve denetimi uygulamanızı sağlar.

Note

Unity Kataloğu gizli dizileri, gizli diziler halinde düzenlenmiş çalışma alanı düzeyinde Azure Databricks gizli dizilerden farklıdır. Gizli bilgileri Unity Catalog ayrıcalıklarıyla yönetmek ve bunlara üç düzeyli ad alanını kullanarak referans vermek istediğinizde Unity Catalog gizli bilgilerini kullanın.

Unity Kataloğu gizli dizileri nasıl çalışır?

Unity Catalog gizli anahtarı, tam nitelikli adı catalog.schema.secret olan, bir şema altında güvenliği yönetilebilen bir nesnedir. Diğer Unity Catalog güvenliği yönetilebilir nesneleri gibi, gizli anahtarlar da katalog ve şemadan ayrıcalıkların devralınmasını destekler. Güvenliği sağlanabilen nesneler ve devralma hakkında daha fazla bilgi için bkz. Unity Catalog güvenliği sağlanabilen nesneler başvurusu.

Unity Catalog gizli anahtarını aşağıdaki şekillerde kullanabilirsiniz:

Koddaki değeri alın. READ SECRET erişimine sahip kullanıcılar, dbutils veya Unity Catalog REST API'sini kullanarak not defterlerinden ve işlerden gizli bir değeri alabilir. Daha sonra dış sistemlerle kimlik doğrulaması yapmak veya verileri şifrelemek ve şifresini çözmek için bunu kullanabilirler.
Değeri Unity Catalog nesnelerinden alın. Unity Kataloğu bağlantıları gibi Unity Kataloğu nesneleri, bir entegrasyonun kullanıcıların giz değerine erişim izni olmadan bu gizi kullanabilmesi için bir gize adıyla başvurabilir. Nesneye bağlı olarak, bir gizli anahtara başvurmak için REFERENCE SECRET veya READ SECRET gerekir.

Azure Databricks, Unity Catalog gizli değerlerini şifrelenmiş biçimde depolar ve çıkışlarda ve günlüklerde kazara açığa çıkmayı azaltmak için gizli değer maskelemesi uygular. Gizli diziyi döndürmek için kullanıcı arabirimindeki veya Unity Kataloğu REST API'sindeki değerini düzenli aralıklarla güncelleştirin.

Unity Catalog gizli anahtarları için ayrıcalıklar

Aşağıdaki ayrıcalıklar gizli bilgiler için geçerlidir. Bunları katalog, şema veya tek tek gizler düzeyinde verebilirsiniz ve bunlar Unity Catalog ayrıcalık devralımını izler.

Privilege	Description
`CREATE SECRET`	Bir kullanıcının bir şemada secret oluşturmasına olanak tanır. Katalog veya şema düzeyinde verilir.
`READ SECRET`	Bir kullanıcının gizli bir değeri almasına olanak tanır.
`WRITE SECRET`	Bir kullanıcının gizli bir değeri güncellemesine izin verir.
`REFERENCE SECRET`	Bir kullanıcının, örneğin bir Unity Catalog bağlantısından, değerine erişmeden bir gizli bilgiye referans vermesine olanak tanır.

Bir şemada gizli anahtar oluşturmak için, kullanıcının USE CATALOG iznine sahip olması ve ayrıca ya şemanın sahibi olması ya da şema üzerinde CREATE SECRET ve USE SCHEMA izinlerine sahip olması gerekir. Ayrıcalıkların nasıl verileceğini öğrenmek için bkz. Unity Kataloğu'nda ayrıcalıkları yönetme.

Başlamadan önce

Unity Kataloğu gizli dizilerini kullanmak için aşağıdaki gereksinimleri karşılamanız gerekir:

Unity Kataloğu için çalışma alanının etkinleştirilmesi gerekir. Giriş için bkz. Unity Kataloğu nedir?.
Gizli anahtarlara Unity Catalog etkinleştirilmiş işlem kaynaklarından erişmelisiniz. Azure Databricks aşağıdakilerden birini önerir:
- Ortam sürümü 4 veya üzerini kullanan sunucusuz işler ve not defterleri.
- Databricks Runtime 17.3 LTS veya üzerini çalıştıran standart erişim modunda klasik işlem.
dbutils ile gizli anahtarları almak için işlem kaynağının Databricks Runtime 17.3 LTS veya üzeri ya da sunucusuz ortam sürümü 4 veya üzeri üzerinde çalışıyor olması gerekir.

Bir sır oluştur.

Bir gizli oluşturmak için USE CATALOG iznine sahip olmanız ve şemanın sahibi olmanız veya şema üzerinde CREATE SECRET ve USE SCHEMA izinlerine sahip olmanız gerekir. Bkz. Unity Catalog gizli anahtarları için ayrıcalıklar.

Katalog Tarayıcısı

Azure Databricks çalışma alanınızda Katalog'a tıklayarak Katalog Gezgini'ne tıklayın.
Gizli anahtarı oluşturmak istediğiniz şemaya gidin.
Gizli Anahtar >Oluştur seçeneğine tıklayın.
Bir ad ve değer girin. İsteğe bağlı olarak, bir yorum ve bir sona erme tarihi ekleyin. Bir gizli anahtarın süresi dolarsa, Katalog Gezgini bir uyarı gösterir.
Oluştur'utıklayın.

REST API

Uç noktayı kullanarak /api/2.1/unity-catalog/secrets aşağıdaki cURL komutunu çalıştırın:

curl -X POST \
  -H "Authorization: Bearer $DATABRICKS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "catalog_name": "main",
    "schema_name": "default",
    "name": "example_secret",
    "value": "your_secret_value",
    "comment": "your secret description"
  }' \
  "$DATABRICKS_HOST/api/2.1/unity-catalog/secrets"

Bir sırrı oku

Bir gizli değeri okumak için, gizli üzerinde veya üst katalog ya da şema üzerinde READ SECRET iznine sahip olmanız gerekir.

Secrets aracı (dbutils.secrets)

Azure Databricks, gizli bilgileri okumak için dbutils kullanmanızı önerir çünkü gizli bilgilerin sansürlenmesini uygular. Bu seçenek Databricks Runtime 17.3 LTS veya üzeri ya da sunucusuz ortam sürüm 4 veya üzeri gerektirir.

# Read a specific secret
my_secret = dbutils.secrets.get(catalog="main", schema="default", key="example_secret")

Daha fazla bilgi için bkz: Gizli Diziler yardımcı programı (dbutils.secrets).

REST API

Warning

Unity Catalog REST API’si aracılığıyla alınan gizli değerler, gizli bilgi maskelemesine tabi değildir; ancak erişimin kaydı yine de denetim günlüklerinde tutulur. bunun yerine Azure Databricks önerirdbutils.

Değeri döndürmek için include_value=true öğesini ayarlayın ve yanıttaki effective_value alanını okuyun:

curl -G \
  -H "Authorization: Bearer $DATABRICKS_TOKEN" \
  --data-urlencode "include_value=true" \
  "$DATABRICKS_HOST/api/2.1/unity-catalog/secrets/main.default.example_secret"

Gizli bilgilerin izinlerini yönet

Kimlerin giz oluşturabileceğini denetlemek için katalog veya şema düzeyinde CREATE SECRET izin verin. Erişimi denetlemek için READ SECRET, WRITE SECRET veya REFERENCE SECRET iznini katalog, şema ya da tek tek gizli düzeyinde verin. Ayrıcalık devralma uygulanır. Ayrıcalıkları verme ve iptal etme hakkında daha fazla bilgi edinmek için bkz. Unity Kataloğu'nda ayrıcalıkları yönetme.

Gizli anahtar oluşturma izni tanı

Katalog Tarayıcısı

Katalog Gezgini'nde şemaya gidin.
İzinler sekmesine tıklayın.
İzin ver düğmesine tıklayın.
Erişim izni verilecek yetkilileri seçin, ardından GİZLİ ANAHTAR OLUŞTUR'u seçin.

Bir sorumluya sahip USE SCHEMAdeğilse, bir uyarı sizden bunu vermenizi ister. USE SCHEMA şemada gizli diziler oluşturmak için de gereklidir.
Onayla'yı tıklatın.

SQL

GRANT CREATE SECRET, USE SCHEMA ON SCHEMA main.default TO `user@example.com`;

REST API

Uç noktayı kullanarak /api/2.1/unity-catalog/permissions/schema/{schema_name} aşağıdaki cURL komutunu çalıştırın:

curl -X PATCH \
  -H "Authorization: Bearer $DATABRICKS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "changes": [{
      "principal": "user@example.com",
      "add": ["CREATE_SECRET", "READ_SECRET", "REFERENCE_SECRET", "WRITE_SECRET"]
    }]
  }' \
  "$DATABRICKS_HOST/api/2.1/unity-catalog/permissions/schema/{schema_name}"

Bir gizliye erişim izni ver

Katalog Tarayıcısı

Katalog Gezgini'nde gizli anahtara gidin ve üzerine tıklayın.
İzinler sekmesine tıklayın.
İzin ver düğmesine tıklayın.
Vermek istediğiniz sorumluları ve ayrıcalıkları seçin, ardından Onayla'ya tıklayın.

SQL

GRANT READ SECRET ON SECRET main.default.example_secret TO `user@example.com`;

REST API

Uç noktayı kullanarak /api/2.1/unity-catalog/permissions/secret/{catalog.schema.secret} aşağıdaki cURL komutunu çalıştırın:

curl -X PATCH \
  -H "Authorization: Bearer $DATABRICKS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "changes": [{
      "principal": "user@example.com",
      "add": ["READ_SECRET", "REFERENCE_SECRET", "WRITE_SECRET"]
    }]
  }' \
  "$DATABRICKS_HOST/api/2.1/unity-catalog/permissions/secret/{catalog.schema.secret}"

Gizli anahtarları listeleme, güncelleştirme ve silme

Gizlilikleri listele

Katalog Tarayıcısı

Katalog Gezgini'nde şemaya gidin.
Şemadaki tüm gizli dizileri görmek için Genel Bakış bölmesinde Gizli Diziler'e tıklayın.

Secrets aracı (dbutils.secrets)

# List all secrets in a schema
all_secrets = dbutils.secrets.list(catalog="main", schema="default")

REST API

Sonuçların sayısını denetlemek için kullanılan page_size liste istekleri:

curl -G \
  -H "Authorization: Bearer $DATABRICKS_TOKEN" \
  --data-urlencode "catalog_name=main" \
  --data-urlencode "schema_name=default" \
  "$DATABRICKS_HOST/api/2.1/unity-catalog/secrets"

Gizli anahtarı güncelle

Bir gizli değeri güncellemek için, gizli üzerinde WRITE SECRET yetkiniz olmalıdır.

Katalog Tarayıcısı

Katalog Gezgini'nde şemaya gidin ve Genel Bakış bölmesinde Gizli Diziler'e tıklayın.
Güncellemek için gizli öğeye tıklayın.
Sağ üst köşede kebap menüsüne (dikey noktalar) tıklayın ve Düzenle'yi seçin.
Yeni bir değer veya son kullanma tarihi girip Onayla'ya tıklayın.

REST API

Güncelleştirme istekleri parametresini update_mask gerektirir. Yalnızca hem update_mask içinde hem de istek gövdesinde yer alan alanlar güncellenir:

curl -X PATCH \
  -H "Authorization: Bearer $DATABRICKS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"value": "new_secret_value"}' \
  "$DATABRICKS_HOST/api/2.1/unity-catalog/secrets/main.default.example_secret?update_mask=*"

Bir sırrı sil

Katalog Tarayıcısı

Katalog Gezgini'nde şemaya gidin ve Genel Bakış bölmesinde Gizli Diziler'e tıklayın.
Silmek için gize tıklayın.
Sağ üst köşede kebap menüsüne (dikey noktalar) tıklayın ve Sil'i seçin.
Gizli anahtarın tam adını girin, ardından Sil düğmesine tıklayın.

REST API

curl -X DELETE \
  -H "Authorization: Bearer $DATABRICKS_TOKEN" \
  "$DATABRICKS_HOST/api/2.1/unity-catalog/secrets/main.default.example_secret"

Unity Catalog gizli anahtarları için denetim olayları

system.access.audit sistem tablosu, Unity Catalog gizli anahtarlarıyla ilgili olayları kaydeder. Örneğin, belirli bir tarihte kullanıcının tüm gizli dizi olaylarını görmek için aşağıdaki sorguyu çalıştırın:

SELECT * FROM system.access.audit
WHERE
  user_identity.email = "user@example.com"
  AND event_date = "2026-02-20"
  AND service_name = "unityCatalog"
  AND action_name LIKE "%Secret%";

Denetim günlükleri hakkında daha fazla bilgi için bkz. Denetim günlüğü sistemi tablo başvurusu.

Gizli değerleri müşteri tarafından yönetilen anahtarlarla şifreleyin

varsayılan olarak, Azure Databricks gizli dizi değerlerini Databricks tarafından yönetilen anahtarlarla şifreler. Bunun yerine müşteri tarafından yönetilen anahtarları (CMK) kullanabilirsiniz. CMK ile şifrelenmiş yönetilen katalog özelliğini etkinleştirir ve hesabınıza bir CMK yapılandırması eklerseniz Azure Databricks gizli dizi değerlerini şifrelemek için CMK kullanır. Daha fazla bilgi için bkz. Unity Kataloğu için müşteri tarafından yönetilen anahtarlar.

Limitations

Unity Kataloğu gizli anahtarları aşağıdaki sınırlamalara sahiptir:

SQL ambarı yok. Unity Kataloğu gizli dizileri SQL ambarlarında desteklenmez. Unity Catalog etkin işlem kaynaklarında Databricks Runtime 17.3 LTS veya üzeri ya da sunucusuz işlem gerektirir.
Genel keşif yok. Unity Kataloğu gizli anahtarları genel aramada görüntülenmez.
BROWSE izni desteklenmiyor. BROWSE katalog üzerindeki Unity Catalog gizli anahtarları için geçerli değildir. Bir gizli bilgiyi bulunabilir hale getirmek için, gizli bilginin kendisi veya şeması üzerinde READ SECRET ya da REFERENCE SECRET yetkisi verin.
Başlatma betikleri yok. Unity Kataloğu gizli dizilerini genel veya küme başlatma betiklerinde kullanamazsınız. Azure Databricks mümkün olduğunda başlatma betikleri yerine ayrılmış özelliklerin kullanılmasını önerir.
Bilgi şeması yok. Gizli anahtarlar için bilgi şeması tabloları henüz mevcut değildir. Bulma için Katalog Gezgini'ni veya REST API'yi kullanın.
dbutils çalışma zamanı kapsamı. dbutils alma, Databricks Runtime destekli not defterlerinde ve işlerde desteklenir. Uzaktan geliştirme veya derlenmiş JAR çalıştırma modları gibi Databricks Runtime dışı bağlamlar desteklenmez.
OAuth API kapsamı. Unity Catalog gizli anahtarlar API'sine yalnızca unity-catalog OAuth API kapsamı ile erişilebilir. secrets API kapsamını yalnızca çalışma alanı düzeyinde Azure Databricks gizli dizileri için kullanın.
Kota sınırı. Şema başına en fazla 100 gizli anahtar ve metaveri deposu başına 1.000 gizli anahtar.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-07-17

Unity Catalog’daki Gizli Bilgiler

Unity Kataloğu gizli dizileri nasıl çalışır?

Unity Catalog gizli anahtarları için ayrıcalıklar

Başlamadan önce

Bir sır oluştur.

Katalog Tarayıcısı

REST API

Bir sırrı oku

Secrets aracı (dbutils.secrets)

REST API

Gizli bilgilerin izinlerini yönet

Gizli anahtar oluşturma izni tanı

Katalog Tarayıcısı

SQL

REST API

Bir gizliye erişim izni ver

Katalog Tarayıcısı

SQL

REST API

Gizli anahtarları listeleme, güncelleştirme ve silme

Gizlilikleri listele

Katalog Tarayıcısı

Secrets aracı (dbutils.secrets)

REST API

Gizli anahtarı güncelle

Katalog Tarayıcısı

REST API

Bir sırrı sil

Katalog Tarayıcısı

REST API

Unity Catalog gizli anahtarları için denetim olayları

Gizli değerleri müşteri tarafından yönetilen anahtarlarla şifreleyin

Limitations

Geri Bildirim

Ek kaynaklar