quality-monitors 명령 그룹

quality-monitors 내의 명령 그룹에는 품질 모니터를 만들고, 편집하고, 삭제하는 명령이 포함되어 있습니다. 모니터는 시간이 지남에 따라 테이블에 대한 데이터 또는 모델 품질 메트릭을 계산하고 모니터링합니다. 테이블 상태를 모니터링하고 경고를 설정하는 데 사용할 수 있는 메트릭 테이블과 대시보드를 생성합니다. 데이터 프로파일링을 참조하세요.

databricks 품질 모니터 만들기

지정된 테이블에 대한 새 모니터를 만듭니다.

호출자는 다음 중 하나를 수행해야 합니다.

1. 테이블의 부모 카탈로그를 소유하고, 테이블의 부모 스키마에 대한 USE_SCHEMA 권한을 가지며, 테이블에 대한 SELECT 액세스 권한을 가져야 합니다.
2. 테이블의 부모 카탈로그에 대한 USE_CATALOG을(를) 가지고 있으며, 테이블의 부모 스키마의 소유자이고, 테이블에 대한 SELECT 액세스를 가지고 있습니다.
3. "이 기능에는 다음 권한이 있습니다."
   • USE_CATALOG 테이블의 부모 카탈로그에
   • USE_SCHEMA 테이블의 부모 스키마에서
   • 테이블의 소유자가 됩니다.

대시보드와 같은 작업 영역 자산은 이 호출이 수행된 작업 영역에 만들어집니다.

databricks quality-monitors create TABLE_NAME ASSETS_DIR OUTPUT_SCHEMA_NAME [flags]

Arguments

TABLE_NAME

    테이블의 전체 이름입니다.

ASSETS_DIR

    모니터링 자산(예: 대시보드, 메트릭 테이블)을 저장할 디렉터리입니다.

OUTPUT_SCHEMA_NAME

    출력 메트릭 테이블이 만들어지는 스키마입니다.

Options

--baseline-table-name string

    드리프트 메트릭이 계산되는 기준 테이블의 이름입니다.

--json JSON

    요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

--skip-builtin-dashboard

    데이터 품질 메트릭을 요약하는 기본 대시보드 만들기를 건너뛸지 여부입니다.

--warehouse-id string

    대시보드 만들기를 위해 웨어하우스를 지정하는 선택적 인수입니다.

전역 플래그

Examples

다음 예제에서는 테이블에 대한 품질 모니터를 만듭니다.

databricks quality-monitors create main.my_schema.my_table /monitoring/assets main.monitoring_schema

databricks 품질 모니터 삭제

지정된 테이블에 대한 모니터를 삭제합니다.

호출자는 다음 중 하나를 수행해야 합니다.

1. 테이블의 부모 카탈로그 소유자여야 합니다.
2. 테이블의 부모 카탈로그에 USE_CATALOG가 있어야 하고, 테이블의 부모 스키마의 소유자여야 합니다.
3. "이 기능에는 다음 권한이 있습니다."
   • USE_CATALOG 테이블의 부모 카탈로그에
   • USE_SCHEMA 테이블의 부모 스키마에서
   • 테이블의 소유자가 됩니다.

또한 모니터가 만들어진 작업 영역에서 호출을 수행해야 합니다.

메트릭 테이블 및 대시보드는 이 호출의 일부로 삭제되지 않습니다. 이러한 자산은 수동으로 정리해야 합니다(원하는 경우).

databricks quality-monitors delete TABLE_NAME [flags]

Arguments

TABLE_NAME

    테이블의 전체 이름입니다.

Options

전역 플래그

Examples

다음 예제에서는 품질 모니터를 삭제합니다.

databricks quality-monitors delete main.my_schema.my_table

databricks 품질 모니터 가져오기

지정된 테이블에 대한 모니터를 가져옵니다.

호출자는 다음 중 하나를 수행해야 합니다.

1. 테이블의 부모 카탈로그 소유자여야 합니다.
2. USE_CATALOG 테이블의 부모 카탈로그에 있고 테이블의 부모 스키마의 소유자가 됩니다.
3. "이 기능에는 다음 권한이 있습니다."
   • USE_CATALOG 테이블의 부모 카탈로그에
   • USE_SCHEMA 테이블의 부모 스키마에서
   • SELECT 테이블에 대한 권한입니다.

반환된 정보에는 구성 값과 모니터에서 만든 자산에 대한 정보가 포함됩니다. 호출자가 모니터를 만든 위치와 다른 작업 영역에 있는 경우 일부 정보(예: 대시보드)를 필터링할 수 있습니다.

databricks quality-monitors get TABLE_NAME [flags]

Arguments

TABLE_NAME

    테이블의 전체 이름입니다.

Options

전역 플래그

Examples

다음 예제에서는 품질 모니터에 대한 정보를 가져옵니다.

databricks quality-monitors get main.my_schema.my_table

Databricks 품질 모니터 get-refresh

지정된 새로 고침 ID를 사용하여 특정 모니터 새로 고침에 대한 정보를 가져옵니다.

호출자는 다음 중 하나를 수행해야 합니다.

1. 테이블의 부모 카탈로그 소유자여야 합니다.
2. 테이블의 부모 카탈로그에 USE_CATALOG가 있어야 하고, 테이블의 부모 스키마의 소유자여야 합니다.
3. "이 기능에는 다음 권한이 있습니다."
   • USE_CATALOG 테이블의 부모 카탈로그에
   • USE_SCHEMA 테이블의 부모 스키마에서
   • SELECT 테이블에 대한 권한입니다.

또한 모니터가 만들어진 작업 영역에서 호출을 수행해야 합니다.

databricks quality-monitors get-refresh TABLE_NAME REFRESH_ID [flags]

Arguments

TABLE_NAME

    테이블의 전체 이름입니다.

REFRESH_ID

    새로 고침의 ID입니다.

Options

전역 플래그

Examples

다음 예제에서는 특정 새로 고침에 대한 정보를 가져옵니다.

databricks quality-monitors get-refresh main.my_schema.my_table 12345

databricks 품질 모니터 목록을 새로 고침

이 테이블의 가장 최근 새로 고침 기록(최대 25개)을 나열합니다.

호출자는 다음 중 하나를 수행해야 합니다.

1. 테이블의 부모 카탈로그 소유자여야 합니다.
2. 테이블의 부모 카탈로그에 USE_CATALOG가 있어야 하고, 테이블의 부모 스키마의 소유자여야 합니다.
3. "이 기능에는 다음 권한이 있습니다."
   • USE_CATALOG 테이블의 부모 카탈로그에
   • USE_SCHEMA 테이블의 부모 스키마에서
   • SELECT 테이블에 대한 권한입니다.

또한 모니터가 만들어진 작업 영역에서 호출을 수행해야 합니다.

databricks quality-monitors list-refreshes TABLE_NAME [flags]

Arguments

TABLE_NAME

    테이블의 전체 이름입니다.

Options

전역 플래그

Examples

다음 예제에서는 품질 모니터에 대한 새로 고침을 나열합니다.

databricks quality-monitors list-refreshes main.my_schema.my_table

databricks 품질 모니터 실행 갱신

지정된 테이블에 대한 메트릭 새로 고침을 모니터링 시스템에서 대기열에 추가합니다. 새로 고침이 백그라운드에서 실행됩니다.

호출자는 다음 중 하나를 수행해야 합니다.

1. 테이블의 부모 카탈로그 소유자여야 합니다.
2. 테이블의 부모 카탈로그에 USE_CATALOG가 있어야 하고, 테이블의 부모 스키마의 소유자여야 합니다.
3. "이 기능에는 다음 권한이 있습니다."
   • USE_CATALOG 테이블의 부모 카탈로그에
   • USE_SCHEMA 테이블의 부모 스키마에서
   • 테이블의 소유자여야 합니다.

또한 모니터가 만들어진 작업 영역에서 호출을 수행해야 합니다.

databricks quality-monitors run-refresh TABLE_NAME [flags]

Arguments

TABLE_NAME

    테이블의 전체 이름입니다.

Options

전역 플래그

Examples

다음 예제에서는 품질 모니터에 대한 새로 고침을 큐에 대기합니다.

databricks quality-monitors run-refresh main.my_schema.my_table

databricks 품질 모니터 업데이트

지정된 테이블에 대한 모니터를 업데이트합니다.

호출자는 다음 중 하나를 수행해야 합니다.

1. 테이블의 부모 카탈로그 소유자여야 합니다.
2. 테이블의 부모 카탈로그에 USE_CATALOG가 있어야 하고, 테이블의 부모 스키마의 소유자여야 합니다.
3. "이 기능에는 다음 권한이 있습니다."
   • USE_CATALOG 테이블의 부모 카탈로그에
   • USE_SCHEMA 테이블의 부모 스키마에서
   • 테이블의 소유자가 됩니다.

또한 모니터가 만들어진 작업 영역에서 호출을 수행해야 하며 호출자는 모니터의 원래 작성자여야 합니다.

출력 자산 식별자와 같은 특정 구성 필드는 업데이트할 수 없습니다.

databricks quality-monitors update TABLE_NAME OUTPUT_SCHEMA_NAME [flags]

Arguments

TABLE_NAME

    테이블의 전체 이름입니다.

OUTPUT_SCHEMA_NAME

    출력 메트릭 테이블이 만들어지는 스키마입니다.

Options

--baseline-table-name string

    드리프트 메트릭이 계산되는 기준 테이블의 이름입니다.

--dashboard-id string

    계산된 메트릭을 시각화하는 대시보드의 ID입니다.

--json JSON

    요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.

전역 플래그

Examples

다음 예제에서는 품질 모니터를 업데이트합니다.

databricks quality-monitors update main.my_schema.my_table main.monitoring_schema

다음 예제에서는 품질 모니터를 새 기준 테이블로 업데이트합니다.

databricks quality-monitors update main.my_schema.my_table main.monitoring_schema --baseline-table-name main.my_schema.new_baseline

전역 표시기

--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 문자열

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