Aracılığıyla paylaş

secret işlevi

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL önizlemesi onay işareti evet olarak işaretlenmiş Databricks Runtime 11.3 LTS ve üzeri

Verilen scope ve key ile Databricks gizli hizmetinden bir gizli değer ayıklar.

Söz dizimi

secret ( scope, key )

Argümanlar

  • scope: Ayıklanacak gizli bilginin kapsamını içeren sabit metin ifadesi. Kapsam, birden çok anahtarın bulunabileceği ad alanıdır.
  • key: Ayıklanacak sırrın anahtarına sahip sabit bir dize ifadesi.

İadeler

Bir STRING.

Anahtar alınamıyorsa işlev INVALID_SECRET_LOOKUP yükseltir. Bunun yerine NULL dönmek için try_secret() işlevini kullanın.

Kullanıcının görme yetkisine sahip olduğu tüm gizli bilgilerin listesini almak için list_secrets işlevini kullanın.

Uyarı

Azure Databricks, ham çıktıdan gizli bilgileri çıkarmak için en iyi çabayı gösterir. Daha fazla bilgi için bkz Gizli düzenleme.

Hata koşulları

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT key: sabit bir dize değildir.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT scope: sabit bir dize değildir.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: Databricks gizli hizmeti kullanılamıyor.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: key içinde scope bulunamıyor.

Örnekler

> SELECT * FROM list_secrets();
  scope         key
  ------------  ---------------
  secrets.r.us  theAnswerToLife

> SELECT secret('secrets.r.us', 'theAnswerToLife');
  fourtyTwo

> SELECT secret('secrets.r.us', 'WhatIsTheAnswerToLife');
  Error: INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED