다음을 통해 공유


secret 기능

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

scope에서 지정된 key로 비밀 값을 추출합니다.

구문

secret ( scope, key )

인수

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

반품

STRING.

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

사용자가 권한이 있는 모든 비밀의 list를 검색하려면, list_secrets 함수를 사용하십시오.

오류 조건

  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_KEY_NOT_CONSTANT: key는 상수 문자열이 아닙니다.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_SCOPE_NOT_CONSTANT: scope는 상수 문자열이 아닙니다.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_NOT_SUPPORTED: Databricks 비밀 서비스를 사용할 수 없습니다.
  • INVALID_SECRET_LOOKUP.SECRET_FUNCTION_LOOKUP_FAILED: key 내에서 scope를 찾을 수 없습니다.

예제

> 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