Dela via


Funktionen try_secret

Gäller för:markerad ja Databricks SQL preview markerad ja Databricks Runtime 15.0 och senare

Extraherar ett hemligt värde med angivet scope och key från Databricks secret service, eller NULL om nyckeln inte kan hämtas.

Syntax

try_secret ( scope, key )

Argument

  • scope: Ett konstant stränguttryck som innehåller hemlighetens omfång som ska extraheras. Omfånget är det namnområde där flera nycklar kan finnas.
  • key: Ett konstant stränguttryck med nyckeln för hemligheten som ska extraheras.

Returer

En STRING.

Om nyckeln inte kan hämtas returnerar NULLfunktionen . Använd funktionen secret() för att skapa INVALID_SECRET_LOOKUP i stället.

Om du vill hämta en lista över alla hemligheter som användaren har behörighet att se använder du funktionen list_secrets .

Feltillstånd

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: Är key inte en konstant sträng.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: Är scope inte en konstant sträng.

Exempel

> 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