모델 삭제

이 페이지는 BigQuery ML 모델을 삭제하는 방법을 설명합니다. 다음 방법을 사용하여 모델을 삭제할 수 있습니다.

  • GCP Console 사용
  • 명령줄 도구의 bq rm 또는 bq query 명령어 사용
  • models.delete API 메소드를 호출하거나 jobs.query 메소드 호출
  • 클라이언트 라이브러리 사용

현재는 한 번에 하나의 모델만 삭제할 수 있습니다. 모델을 삭제하면 모델에 포함된 데이터도 모두 삭제됩니다.

지정된 기간 후에 모델을 자동으로 삭제하려면 CLI, API 또는 클라이언트 라이브러리를 사용하여 모델을 생성할 때 모델의 만료 시간을 설정합니다. 모델을 만들 때 만료 시간을 설정하지 않은 경우 모델을 업데이트할 수 있습니다.

모델 삭제 제한사항

모델을 삭제하는 경우 다음과 같은 제한사항이 있습니다.

  • 동시에 여러 모델을 삭제할 수 없습니다. 모델은 개별적으로 삭제해야 합니다.
  • 모델 삭제는 실행 취소할 수 없습니다.

필수 권한

데이터세트의 모델을 삭제하려면 데이터세트에 대한 WRITER 역할을 할당받거나, bigquery.models.delete 권한을 포함하는 프로젝트 수준 IAM 역할을 할당받아야 합니다. 프로젝트 수준에서 bigquery.models.delete 권한을 할당받으면 프로젝트의 모든 데이터세트에서 모델을 삭제할 수 있습니다. 다음 프로젝트 수준의 IAM 역할에는 bigquery.models.delete 권한이 포함됩니다.

  • bigquery.dataEditor
  • bigquery.dataOwner
  • bigquery.admin

BigQuery ML의 IAM 역할과 권한에 대한 자세한 내용은 액세스 제어를 참조하세요. 데이터세트 수준 역할에 대한 자세한 내용은 BigQuery 문서의 데이터세트 기본 역할을 참조하세요.

모델 삭제

모델을 삭제하려면 다음 단계를 따릅니다.

콘솔

모델 삭제 옵션을 사용하거나 DROP MODEL | DROP MODEL IF EXISTS DDL 문을 포함하는 쿼리를 실행하여 BigQuery 웹 UI에서 모델을 삭제할 수 있습니다.

옵션 1: 모델 삭제 옵션 사용

  1. GCP Console에서 BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 탐색 패널의 리소스 섹션에서 프로젝트 이름과 데이터세트 이름을 확장합니다.

  3. 모델 이름을 클릭합니다. 모델은 모델 아이콘 모델 아이콘으로 표시됩니다.

  4. 창 오른쪽에서 모델 삭제를 클릭합니다.

  5. 모델 삭제 대화 상자에서 모델의 이름을 입력한 다음 삭제를 클릭합니다.

옵션 2: DDL 문 사용

  1. BigQuery 웹 UI로 이동합니다.

    BigQuery 웹 UI로 이동

  2. 쿼리 작성을 클릭합니다.

  3. 새 쿼리 텍스트 영역에 DDL 문을 입력합니다.

     DROP MODEL mydataset.mymodel
     

  4. 쿼리 실행을 클릭합니다. 쿼리가 완료되면 탐색 창에서 모델이 삭제됩니다.

CLI

다음 명령어를 입력하여 bq 명령줄 도구로 모델을 삭제할 수 있습니다.

  • bq rm 명령어(--model 또는 -m 플래그와 함께 사용)
  • bq query 명령어 및 DDL 문을 쿼리 매개변수로 제공

기본 프로젝트가 아닌 다른 프로젝트에서 모델을 삭제하는 경우 [PROJECT_ID]:[DATASET].[MODEL] 형식으로 데이터세트에 프로젝트 ID를 추가합니다.

옵션 1: bq rm 명령어 입력

bq rm 명령어를 사용하여 모델을 삭제하는 경우 작업을 확인해야 합니다. --force 플래그(또는 -f 단축형)를 사용하면 확인을 건너뛸 수 있습니다.

bq rm -f --model [PROJECT_ID]:[DATASET].[MODEL]

각 항목의 의미는 다음과 같습니다.

  • [PROJECT_ID]는 프로젝트 ID입니다.
  • [DATASET]는 데이터세트 이름입니다.
  • [MODEL]은 삭제할 모델의 이름입니다.

rm 명령어는 출력을 생성하지 않습니다.

예:

다음 명령어를 입력하여 mydataset에서 mymodel을 삭제합니다. mydataset는 기본 프로젝트에 있습니다.

bq rm --model mydataset.mymodel

다음 명령어를 입력하여 mydataset에서 mymodel을 삭제합니다. mydataset는 기본 프로젝트가 아니라 myotherproject에 있습니다.

bq rm --model myotherproject:mydataset.mymodel

다음 명령어를 입력하여 mydataset에서 mymodel을 삭제합니다. mydataset는 기본 프로젝트에 있습니다. 이 명령어는 -f 단축형을 사용하여 확인을 건너뜁니다.

bq rm -f --model mydataset.mymodel

bq ls 명령어를 실행하여 모델이 삭제되었는지 확인할 수 있습니다. 자세한 내용은 모델 나열을 참조하세요.

옵션 2: bq query 명령어 입력

bq query 명령어를 사용하여 모델을 삭제하려면 쿼리 매개변수에 DROP MODEL 문을 제공하고 --use_legacy_sql=false 플래그를 제공하여 표준 SQL 쿼리 구문을 지정합니다.

예:

다음 명령어를 입력하여 mydataset에서 mymodel을 삭제합니다. mydataset는 기본 프로젝트에 있습니다.

bq query --use_legacy_sql=false 'DROP MODEL mydataset.mymodel'

다음 명령어를 입력하여 mydataset에서 mymodel을 삭제합니다. mydataset는 기본 프로젝트가 아니라 myotherproject에 있습니다.

bq query --use_legacy_sql=false \
'DROP MODEL myotherproject:mydataset.mymodel'

API

옵션 1: models.delete 메소드 호출

모델을 삭제하려면 models.delete 메소드를 호출하고 projectId, datasetId, modelId를 제공합니다.

옵션 2: jobs.query 메소드 호출

모델을 삭제하려면 jobs.query 메소드를 호출하고 요청 분문의 쿼리 속성에 DROP MODEL DDL 문을 제공합니다.

삭제된 모델 복원

현재 삭제된 모델은 복원할 수 없습니다.

다음 단계

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

BigQuery ML 문서