다음을 통해 공유


try_secret 기능

적용 대상: 예로 표시된 확인 Databricks SQL 미리 보기 예로 표시된 확인 Databricks Runtime 15.0 이상

Databricks 비밀 서비스에서 주어진 scopekey를 사용하여 비밀 값을 추출하거나 키를 검색할 수 없는 경우 NULL를 추출합니다.

구문

try_secret ( scope, key )

인수

  • scope: 추출할 비밀의 범위를 포함하는 상수 문자열 식입니다. 범위는 여러 키가 상주할 수 있는 네임스페이스입니다.
  • key: 추출할 비밀의 키가 있는 상수 문자열 식입니다.

반품

STRING.

키를 검색할 수 없으면 함수가 반환됩니다 NULL. 대신 INVALID_SECRET_LOOKUP 발생하려면 secret() 함수를 사용합니다.

사용자가 볼 수 있는 모든 비밀 목록을 검색하려면 list_secrets 함수를 사용합니다.

오류 조건

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: key는 상수 문자열이 아닙니다.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: scope는 상수 문자열이 아닙니다.

예제

> 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