Udostępnij za pośrednictwem

Funkcja try_secret

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ść tajną z daną scope i key z usługi wpisów tajnych Databricks, lub NULL jeżeli nie można pobrać klucza.

Składnia

try_secret ( scope, key )

Argumenty

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

Zwraca

A 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, do których użytkownik jest uprawniony do zobaczenia, użyj 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