Note
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
functions
Databricks CLI 내의 명령 그룹을 사용하면 Unity 카탈로그에서 UDF(사용자 정의 함수)를 관리할 수 있습니다. 함수 구현은 모든 SQL 식 또는 쿼리일 수 있으며 쿼리에서 테이블 참조가 허용되는 모든 위치에서 호출할 수 있습니다. Unity 카탈로그에서 함수는 테이블과 동일한 수준에 있으므로 폼 catalog_name.schema_name.function_name으로 참조할 수 있습니다.
databricks 함수 생성
새 함수를 만듭니다.
Important
이 기능은 실험 기능입니다.
함수를 만들려면 사용자에게 다음 권한이 있어야 합니다.
-
USE_CATALOG 함수의 부모 카탈로그에
- 함수의 부모 스키마에 있는
USE_SCHEMA및CREATE_FUNCTION
databricks functions create [flags]
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
Examples
다음 예제에서는 JSON 파일을 사용하여 함수를 만듭니다.
databricks functions create --json @function-definition.json
다음 예제에서는 인라인 JSON을 사용하여 함수를 만듭니다.
databricks functions create --json '{"name": "my_catalog.my_schema.my_function", "data_type": "INT", "full_data_type": "INT", "return_params": {"parameters": []}, "routine_body": "SQL", "routine_definition": "SELECT 1", "routine_dependencies": {"dependencies": []}, "parameter_style": "S", "is_deterministic": true, "sql_data_access": "CONTAINS_SQL", "is_null_call": false, "security_type": "DEFINER", "specific_name": "my_function"}'
databricks 함수 삭제
제공된 이름과 일치하는 함수를 삭제합니다.
삭제가 성공하려면 사용자가 다음 조건 중 하나를 충족해야 합니다.
- 함수의 부모 카탈로그 소유자입니다.
- 함수의 부모 스키마 소유자이며 부모 카탈로그에
USE_CATALOG대한 권한이 있는 경우 - 함수 자체의 소유자이며, 부모 카탈로그에 대한
USE_CATALOG권한과 부모 스키마에 대한USE_SCHEMA권한을 모두 갖습니다.
databricks functions delete NAME [flags]
Arguments
NAME
함수의 정규화된 이름은 catalog_name.schema_name.function_name 형식입니다.
Options
--force
함수가 주의해야 하는 경우에도 강제로 삭제합니다.
Examples
다음 예제에서는 함수를 삭제합니다.
databricks functions delete my_catalog.my_schema.my_function
다음 예제에서는 함수를 강제로 삭제합니다.
databricks functions delete my_catalog.my_schema.my_function --force
databricks 함수 가져오기
부모 카탈로그 및 스키마 내에서 함수를 가져옵니다.
페치에 성공하려면 사용자가 다음 요구 사항 중 하나를 충족해야 합니다.
- metastore 관리자입니다.
- 함수의 부모 카탈로그 소유자입니다.
-
USE_CATALOG함수의 부모 카탈로그에 대한 권한을 가지며 함수의 소유자가 됩니다. -
USE_CATALOG함수의 부모 카탈로그에 대한 권한,USE_SCHEMA함수의 부모 스키마에 대한 권한 및EXECUTE함수 자체에 대한 권한을 갖습니다.
databricks functions get NAME [flags]
Arguments
NAME
함수의 정규화된 이름은 catalog_name.schema_name.function_name 형식입니다.
Options
--include-browse
사용자가 선택적 메타데이터에만 액세스할 수 있는 경우 응답에 함수를 포함할지 여부입니다.
Examples
다음 예제에서는 함수에 대한 정보를 가져옵니다.
databricks functions get my_catalog.my_schema.my_function
다음 예제에서는 찾아보기 정보가 포함된 함수를 가져옵니다.
databricks functions get my_catalog.my_schema.my_function --include-browse
databricks 함수 목록
지정된 부모 카탈로그 및 스키마 내의 함수를 나열합니다.
사용자가 metastore 관리자인 경우 모든 함수가 출력 목록에 반환됩니다. 그렇지 않으면 사용자는 카탈로그에 대한 USE_CATALOG 권한과 스키마에 대한 USE_SCHEMA 권한을 가져야 하며, 출력 목록에는 사용자에게 EXECUTE 권한이 있거나 사용자가 소유자인 함수만 포함됩니다. 배열에 있는 요소의 특정 순서는 보장되지 않습니다.
databricks functions list CATALOG_NAME SCHEMA_NAME [flags]
Arguments
CATALOG_NAME
관심 있는 함수에 대한 부모 카탈로그의 이름입니다.
SCHEMA_NAME
함수의 부모 스키마입니다.
Options
--include-browse
사용자가 선택적 메타데이터에만 액세스할 수 있는 경우 응답에 함수를 포함할지 여부입니다.
--limit int
반환할 최대 함수 수입니다.
Examples
다음 예제에서는 카탈로그 및 스키마의 모든 함수를 나열합니다.
databricks functions list my_catalog my_schema
다음 예제에서는 최대 10개의 결과가 있는 함수를 나열합니다.
databricks functions list my_catalog my_schema --limit 10
다음 예제에서는 찾아보기 정보가 포함된 함수를 나열합니다.
databricks functions list my_catalog my_schema --include-browse
databricks 함수 업데이트
제공된 이름과 일치하는 함수를 업데이트합니다.
함수의 소유자만 업데이트할 수 있습니다. 사용자가 metastore 관리자가 아닌 경우 사용자는 새 함수 소유자인 그룹의 구성원이어야 합니다. 사용자는 다음 조건 중 하나를 충족해야 합니다.
- metastore 관리자입니다.
- 함수의 부모 카탈로그 소유자입니다.
- 함수의 부모 스키마 소유자이며 부모 카탈로그에
USE_CATALOG대한 권한이 있습니다. - 함수 자체의 소유자이며
USE_CATALOG해당 부모 카탈로그에 대한 권한과USE_SCHEMA함수의 부모 스키마에 대한 권한이 있습니다.
databricks functions update NAME [flags]
Arguments
NAME
함수의 정규화된 이름은 catalog_name.schema_name.function_name 형식입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--owner string
현재 함수 소유자의 사용자 이름입니다.
Examples
다음 예제에서는 함수의 소유자를 업데이트합니다.
databricks functions update my_catalog.my_schema.my_function --owner someone@example.com
전역 표시기
--debug
디버그 로깅을 사용할지 여부입니다.
-h 또는 --help
Databricks CLI 또는 관련 명령 그룹 또는 관련 명령에 대한 도움말을 표시합니다.
--log-file 문자열
출력 로그를 쓸 파일을 나타내는 문자열입니다. 이 플래그가 지정되지 않으면 출력 로그는 기본적으로 stderr에 기록됩니다.
--log-format 포맷
로그 형식 형식 text 또는 json. 기본값은 text입니다.
--log-level 문자열
로그 형식 수준을 나타내는 문자열입니다. 지정하지 않으면 로그 형식 수준을 사용할 수 없습니다.
-o, --output 유형
명령 출력 형식 text 또는 json. 기본값은 text입니다.
-p, --profile 문자열
명령을 실행하는 데 사용할 파일의 프로필 ~/.databrickscfg 이름입니다. 이 플래그를 지정하지 않으면, 존재하는 경우 DEFAULT로 명명된 프로필이 사용됩니다.
--progress-format 포맷
진행률 로그를 표시할 형식: default, append, inplace또는 json
-t, --target 문자열
해당하는 경우 사용할 번들 대상