Udostępnij za pośrednictwem

Funkcja secret

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL preview zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

Wyodrębnia wartość wpisu tajnego z daną scope i key z usługi wpisów tajnych usługi Databricks.

Składnia

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 zgłasza INVALID_SECRET_LOOKUP. Aby zamiast tego powrócićNULL, użyj funkcji try_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.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: Usługa wpisów tajnych usługi Databricks jest niedostępna.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: Nie można odnaleźć obiektu key w pliku scope.

Przykłady

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

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

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