모델 메타데이터 업데이트

개요

이 페이지에서는 BigQuery ML 모델 메타데이터를 업데이트하는 방법을 설명합니다. 다음 방법을 사용하여 모델 메타데이터를 업데이트할 수 있습니다.

  • GCP Console 사용
  • bq update CLI 명령어 사용
  • models.patch API 메소드를 직접 호출하거나 클라이언트 라이브러리를 사용하여 호출

다음 모델 메타데이터를 업데이트할 수 있습니다.

  • 설명: BigQuery 웹 UI, CLI, API 또는 클라이언트 라이브러리를 사용하여 업데이트할 수 있습니다.
  • 라벨: BigQuery 웹 UI, CLI, API 또는 클라이언트 라이브러리를 사용하여 업데이트할 수 있습니다.
  • 만료 시간: CLI, API 또는 클라이언트 라이브러리를 사용하여 업데이트할 수 있습니다.

필수 권한

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

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

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

모델의 설명 업데이트

모델의 설명은 모델을 쉽게 식별하는 데 사용되는 텍스트 문자열입니다.

모델의 설명을 업데이트하려면 다음 단계를 따릅니다.

콘솔

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

    BigQuery 웹 UI로 이동

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

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

  4. 세부정보 탭을 클릭합니다.

  5. 모델의 설명을 업데이트하려면 설명의 오른쪽에 있는 편집 아이콘(연필)을 클릭합니다.

  6. 설명 수정 대화상자에서 텍스트를 클릭한 다음 업데이트를 클릭합니다.

CLI

모델의 설명을 업데이트하려면 bq update 명령어를 --model, -m, --description 플래그와 함께 실행합니다.

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

bq ls --model --description "[STRING]" [PROJECT_ID]:[DATASET].[MODEL]

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

  • [STRING]은 모델을 따옴표로 묶어 설명하는 텍스트 문자열입니다.
  • [PROJECT_ID]는 프로젝트 ID입니다.
  • [DATASET]는 데이터세트 이름입니다.
  • [MODEL]은 모델 이름입니다.

명령어 결과는 다음과 같이 표시됩니다.

Model '[PROJECT_ID]:[DATASET].[MODEL]' successfully updated.

bq show 명령어를 실행하여 변경사항을 확인할 수 있습니다. 자세한 내용은 모델 메타데이터 가져오기를 참조하세요.

예:

다음 명령어를 입력하여 기본 프로젝트에 있는 mydatasetmymodel 설명을 업데이트합니다.

bq update --model --description "My updated description" \
mydataset.mymodel

다음 명령어를 입력하여 myotherproject에서 mydatasetmymodel 설명을 업데이트합니다.

bq update --model --description "My updated description" \
myotherproject:mydataset.mymodel

API

API를 사용하여 모델의 설명을 업데이트하려면 models.patch 메소드를 호출하고 projectId, datasetId, modelId를 제공합니다. 설명을 수정하려면 모델 리소스의 'description' 속성을 추가하거나 업데이트합니다.

모델의 라벨 업데이트

라벨은 리소스에 연결할 수 있는 키-값 쌍입니다. BigQuery ML 리소스를 만들 때 라벨은 선택사항입니다. 자세한 내용은 BigQuery 문서의 라벨 추가 및 사용을 참조하세요.

모델의 라벨을 업데이트하려면 다음 단계를 따릅니다.

콘솔

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

    BigQuery 웹 UI로 이동

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

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

  4. 세부정보 탭을 클릭합니다.

  5. 모델의 라벨을 업데이트하려면 라벨의 오른쪽에 있는 편집 아이콘(연필)을 클릭합니다.

  6. 라벨 수정 대화 상자에서 다음을 수행합니다.

    • 추가 라벨을 적용하려면 라벨 추가를 클릭합니다. 각 키는 데이터세트당 한 번만 사용할 수 있지만 동일한 프로젝트의 여러 데이터세트에 같은 키를 사용할 수 있습니다.
    • 기존 키 또는 값을 수정하여 라벨을 업데이트합니다.
    • 업데이트를 클릭하여 변경사항을 저장합니다.

CLI

모델의 라벨을 업데이트하려면 bq update 명령어를 --model, -m, --set_label 플래그와 함께 실행합니다. 여러 개의 라벨을 추가하거나 업데이트하려면 --set_label 플래그를 반복합니다.

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

bq update --model --set_label [KEY:VALUE] \
[PROJECT_ID]:[DATASET].[MODEL]

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

  • [KEY:VALUE]는 추가하거나 업데이트하려는 라벨에 대한 키:값 쌍에 해당합니다. 기존 라벨과 동일한 키를 지정하는 경우 기존 라벨의 값이 업데이트됩니다. 키는 고유해야 합니다.
  • [PROJECT_ID]는 프로젝트 ID입니다.
  • [DATASET]는 데이터세트 이름입니다.
  • [MODEL]은 모델 이름입니다.

명령어 결과는 다음과 같이 표시됩니다.

Model '[PROJECT_ID]:[DATASET].[MODEL]' successfully updated.

bq show 명령어를 실행하여 변경사항을 확인할 수 있습니다. 자세한 내용은 모델 메타데이터 가져오기를 참조하세요.

예:

mymodeldepartment 라벨을 업데이트하려면 bq update 명령어를 입력하고 department를 라벨 키로 지정합니다. 예를 들어 department:shipping 라벨을 department:logistics로 업데이트하려면 다음 명령어를 입력합니다. mydataset는 기본 프로젝트가 아닌 myotherproject에 있습니다.

bq update --model --set_label department:logistics \
myotherproject:mydataset.mymodel

API

API를 사용하여 모델의 라벨을 업데이트하려면 models.patch 메소드를 호출하고 projectId, datasetId, modelId를 제공합니다. 라벨을 수정하려면 모델 리소스의 'labels' 속성을 추가하거나 업데이트합니다.

모델의 만료 시간 업데이트

모델의 만료 시간은 모델이 삭제되는 시점을 나타내는 타임스탬프 값입니다. CLI, API 또는 클라이언트 라이브러리를 사용하여 모델을 만들 때 모델의 만료 시간을 설정할 수 있습니다. 또한 모델을 만든 후 모델에서 만료 시간을 설정하거나 업데이트할 수 있습니다. 모델의 만료 시간은 '수명' 또는 TTL이라고도 합니다.

모델에 만료 시간을 설정하지 않으면 모델이 만료되지 않으므로 수동으로 모델을 삭제해야 합니다.

만료 시간 값은 값이 설정된 위치에 따라 다르게 표시됩니다. 원하는 세부사항 수준에 따라 적절한 방법을 사용하세요.

  • 명령줄 도구에서는 만료 시간이 현재 UTC 시간의 초 단위로 표시됩니다. 명령줄에서 만료 시간을 지정하면 초 단위의 정수 값이 현재 UTC 타임스탬프에 추가됩니다.
  • API에서는 만료 시간이 해당 세대부터 밀리초 단위로 표시됩니다. 현재 타임스탬프보다 낮은 만료 값을 지정하면 모델이 즉시 만료됩니다.

모델의 만료 시간을 업데이트하려면 다음 단계를 따릅니다.

콘솔

모델의 만료 시간 설정 또는 업데이트는 현재 Google Cloud Platform Console의 BigQuery 웹 UI에서 지원되지 않습니다.

CLI

모델의 만료 시간을 업데이트하려면 bq update 명령어를 --model, -m, --expiration 플래그와 함께 실행합니다.

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

bq update --model --expiration [INTEGER] \
[PROJECT_ID]:[DATASET].[MODEL]

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

  • [INTEGER]는 모델의 수명(초)입니다. 최솟값은 3,600초(1시간)입니다. 만료 시간은 현재 UTC 시간과 정수 값을 더한 값으로 계산됩니다.
  • [PROJECT_ID]는 프로젝트 ID입니다.
  • [DATASET]는 데이터세트 이름입니다.
  • [MODEL]은 모델 이름입니다.

명령어 결과는 다음과 같이 표시됩니다.

Model '[PROJECT_ID]:[DATASET].[MODEL]' successfully updated.

bq show 명령어를 실행하여 변경사항을 확인할 수 있습니다. 자세한 내용은 모델 메타데이터 가져오기를 참조하세요.

예:

다음 명령어를 입력하여 mydatasetmymodel 만료 시간을 5일(432,000초)로 업데이트합니다. mydataset는 기본 프로젝트에 있습니다.

bq update --model --expiration 432000 mydataset.mymodel

다음 명령어를 입력하여 mydatasetmymodel 만료 시간을 5일(432,000초)로 업데이트합니다. mydataset는 기본 프로젝트가 아닌 myotherproject에 있습니다.

bq update --model --expiration 432000 myotherproject:mydataset.mymodel

API

API를 사용하여 모델의 만료 시간을 업데이트하려면 models.patch 메소드를 호출하고 projectId, datasetId, modelId를 제공합니다. 만료 시간을 수정하려면 모델 리소스의 'expirationTime' 속성을 추가하거나 업데이트합니다. 'expirationTime'은 해당 세대부터 밀리초 단위로 표시됩니다.

다음 단계

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

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

BigQuery ML 문서