Delen via

secret-functie

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL Preview vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

Extraheert een geheime waarde met de opgegeven scope en key uit de Databricks-geheime service.

Syntaxis

secret ( scope, key )

Argumenten

  • scope: Een constante tekenreeksexpressie die het bereik van het geheim bevat dat moet worden geëxtraheerd. Het bereik is de naamruimte waarin meerdere sleutels zich mogelijk bevinden.
  • key: Een constante tekenreeksexpressie met de sleutel van het geheim dat moet worden geëxtraheerd.

Retouren

A STRING.

Als de sleutel niet kan worden opgehaald, wordt de functie INVALID_SECRET_LOOKUP. Als u in plaats daarvan wilt terugkerenNULL, gebruikt u de functie try_secret().

Om een lijst op te halen van alle geheimen die de gebruiker mag zien, gebruikt u de functie list_secrets.

Foutvoorwaarden

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: Het key is geen constante tekenreeks.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: Het scope is geen constante tekenreeks.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: Databricks Secret Service is niet beschikbaar.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: De key kan niet worden gevonden binnen scope.

Voorbeelden

> 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