SYSTEM$CANCEL_CLASSIFY_SCHEMA

지정된 스키마의 테이블에 대한 분류 프로세스 취소를 예약합니다. 이 저장 프로시저를 호출하는 데 사용된 역할이 액세스할 수 있는 테이블에 대한 분류 프로세스를 취소할 수 있습니다.

분류 프로세스가 취소되도록 스테이징된 테이블은 테이블을 다시 분류할 때까지 분류되지 않습니다.

구문

SYSTEM$CANCEL_CLASSIFY_SCHEMA( '<object_name>' )
Copy

인자

object_name

분류 프로세스를 취소할 테이블이 포함된 스키마의 이름입니다. 데이터베이스와 스키마가 현재 세션에서 사용되지 않는 경우 이름은 정규화되어야 합니다.

이름은 데이터베이스에 저장된 대로 정확하게 지정해야 합니다. 이름에 특수 문자, 대문자 또는 공백이 포함된 경우 이름은 먼저 큰따옴표로 묶은 다음 작은따옴표로 묶어야 합니다.

반환

저장 프로시저는 지정된 스키마 이름에 따라 다음 형식으로 JSON 오브젝트를 반환합니다.

  • SYSTEM$CLASSIFY_SCHEMA 를 호출하여 분류를 스테이징한 다음 동일한 스키마 이름으로 SYSTEM$CANCEL_CLASSIFY_SCHEMA를 호출하여 분류 프로세스를 취소하는 경우 출력은 다음과 같습니다.

    {
  "failed": [],
  "succeeded": [
    {
      "message": "Classification Cancelled for table [T1].",
      "table_name": "T1"
    },
    {
      "message": "Classification Cancelled for table [T2].",
      "table_name": "T2"
    },
    ...
    }
  ]
}
    Copy

  • SYSTEM$CANCEL_CLASSIFY_SCHEMA를 호출하고 지정된 스키마가 분류를 위해 스테이징되지 않은 경우 출력은 다음과 같습니다.

    {
  "failed": [
    {
      "message": "Unable to cancel classification for table [T1] since its already complete.",
      "table_name": "T1"
    },
    {
      "message": "Unable to cancel classification for table [T2] since its already complete.",
      "table_name": "T2"
    },
    ...
  ],
  "succeeded": []
}
    Copy

여기서

failed

지정된 테이블에 대해 취소 프로세스를 수행할 수 없는 이유를 지정합니다.

succeeded

지정된 테이블에 대해 취소 프로세스가 예약되어 있는지 확인합니다.

사용법 노트

  • 취소 프로세스가 완료되기까지 짧은 시간(초)이 걸릴 수 있습니다. 이는 쿼리를 취소 하는 것과 유사합니다.

  • 지정된 스키마 이름에는 최대 1,000개의 테이블 오브젝트가 포함될 수 있습니다. 스키마에 1,000개 이상의 테이블 오브젝트가 포함된 경우 Snowflake는 오류 메시지를 반환합니다.

  • Snowflake가 제공하는 저장 프로시저는 호출자 권한을 활용합니다. 자세한 내용은 호출자 권한 및 소유자 권한 저장 프로시저 이해하기 섹션을 참조하십시오.

예

스키마의 테이블 분류를 취소합니다.

CALL SYSTEM$CANCEL_CLASSIFY_SCHEMA('hr.tables');
Copy
언어: 한국어