Udostępnij za pośrednictwem

Funkcja try_secret

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL preview zaznacz pole wyboru oznaczone jako tak Databricks Runtime 15.0 lub nowszy

Wyodrębnia wartość wpisu tajnego z daną scope i key z usługi wpisów tajnych usługi Databricks lub NULL jeśli nie można pobrać klucza.

Składnia

try_secret ( scope, key )

Argumenty

  • scope: stałe wyrażenie ciągu zawierające zakres wpisu tajnego do wyodrębnienia. Zakres to przestrzeń nazw, w której może znajdować się wiele kluczy.
  • key: stałe wyrażenie ciągu z kluczem wpisu tajnego do wyodrębnienia.

Zwraca

Klasa STRING.

Jeśli nie można pobrać klucza, funkcja zwraca wartość NULL. Aby zgłosić INVALID_SECRET_LOOKUP zamiast tego, użyj funkcji secret().

Aby pobrać listę wszystkich wpisów tajnych, użytkownik jest autoryzowany do wyświetlania funkcji list_secrets .

Warunki błędu

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: Ciąg key nie jest ciągiem stałym.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: Ciąg scope nie jest ciągiem stałym.

Przykłady

> 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