Dela via

Funktionen secret

  • Artikel

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

Extraherar ett hemligt värde med angivet scope och key från Databricks secret service.

Syntax

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 genererar funktionen INVALID_SECRET_LOOKUP. Om du vill returnera NULL i stället använder du funktionen try_secret().

Om du vill hämta en list av 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.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: Databricks secret service är inte tillgänglig.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: Det key går inte att hitta i scope.

Exempel

> 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