مشاركة عبر


try_secret دالة

ينطبق على: وضع علامة Databricks SQL preview وضع علامة Databricks Runtime 15.0 وما فوق

استخراج قيمة سرية مع معين scope ومن key خدمة Databricks السرية، أو NULL إذا تعذر استرداد المفتاح.

بناء الجملة

try_secret ( scope, key )

الوسيطات

  • scope: تعبير سلسلة ثابت يحتوي على نطاق السر المراد استخراجه. النطاق هو مساحة الاسم التي قد توجد فيها مفاتيح متعددة.
  • key: تعبير سلسلة ثابت مع مفتاح السر المراد استخراجه.

المرتجعات

STRING.

إذا تعذر استرداد المفتاح، ترجع الدالة NULL. لرفع INVALID_SECRET_LOOKUP بدلا من ذلك، استخدم الدالة secret().

لاسترداد قائمة بجميع البيانات السرية التي يخول للمستخدم الاطلاع على استخدام الدالة list_secrets .

حالات الخطأ

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANTkey: ليست سلسلة ثابتة.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANTscope: ليست سلسلة ثابتة.

الأمثلة

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

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

> SELECT try_secret('secrets.r.us', 'WhatIsTheAnswerToLife');
  NULL