try_secret-Funktion

Gilt für: Databricks SQL Preview Databricks Runtime 15.0 und höher

Extrahiert einen Geheimniswert mit dem angegebenen scope- und key-Element aus dem Databricks-Geheimnisdienst, oder NULL, wenn der Schlüssel nicht abgerufen werden kann.

Syntax

try_secret ( scope, key )

Argumente

• scope: Ein konstanter Zeichenfolgenausdruck, der den Bereich des zu extrahierenden Geheimnisses enthält. Der Bereich ist der Namespace, in dem sich mehrere Schlüssel befinden könnten.
• key: Ein konstanter Zeichenfolgenausdruck mit dem Schlüssel des zu extrahierenden Geheimnisses

Gibt zurück

Ein STRING.

Wenn der Schlüssel nicht abgerufen werden kann, gibt die Funktion NULL zurück. Um stattdessen INVALID_SECRET_LOOKUP auszulösen, verwenden Sie die secret()-Funktion.

Verwenden Sie die Funktion list_secrets, um eine Liste aller Geheimnisse abzurufen, für deren Anzeige der Benutzer berechtigt ist.

Fehlerbedingungen

• INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: key ist keine konstante Zeichenfolge.
• INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: scope ist keine konstante Zeichenfolge.

Beispiele

> 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

Zugehörige Funktionen

• list_secrets Tabellenfunktion
• secret Funktion