functions 명령 그룹

functions Databricks CLI 내의 명령 그룹을 사용하면 Unity 카탈로그에서 UDF(사용자 정의 함수)를 관리할 수 있습니다. 함수 구현은 모든 SQL 식 또는 쿼리일 수 있으며 쿼리에서 테이블 참조가 허용되는 모든 위치에서 호출할 수 있습니다. Unity 카탈로그에서 함수는 테이블과 동일한 수준에 있으므로 폼 catalog_name.schema_name.function_name으로 참조할 수 있습니다.

databricks 함수 생성

새 함수를 만듭니다.

함수를 만들려면 사용자에게 다음 권한이 있어야 합니다.

- 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

    사용자가 선택적 메타데이터에만 액세스할 수 있는 경우 응답에 함수를 포함할지 여부입니다.

--max-results int

    반환할 최대 함수 수입니다.

--page-token string

    이전 쿼리를 기반으로 다음 페이지로 이동하기 위한 불투명 페이지네이션 토큰입니다.

전역 플래그

Examples

다음 예제에서는 카탈로그 및 스키마의 모든 함수를 나열합니다.

databricks functions list my_catalog my_schema

다음 예제에서는 최대 10개의 결과가 있는 함수를 나열합니다.

databricks functions list my_catalog my_schema --max-results 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 문자열

    해당하는 경우 사용할 번들 대상