Freigeben über

try_secret-Funktion

  • Artikel

Gilt für: Häkchen gesetzt ja Databricks SQL Preview Häkchen gesetzt ja 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