BigQuery 라벨 추가

이 문서에서는 Dataform에서 테이블에 라벨을 추가하는 방법을 보여줍니다.

BigQuery는 리소스에 라벨을 추가하는 기능을 지원합니다. BigQuery의 라벨에 관한 자세한 내용은 라벨 소개를 참고하세요.

시작하기 전에

  1. Google Cloud 콘솔에서 Dataform 페이지로 이동합니다.

    Dataform 페이지로 이동

  2. 저장소를 선택하거나 만듭니다.

  3. 개발 작업공간을 선택하거나 만듭니다.

  4. 테이블을 만듭니다.

필요한 역할

Dataform 테이블에 BigQuery 라벨을 추가하는 데 필요한 권한을 얻으려면 관리자에게 작업공간에 대한 Dataform 편집자(roles/dataform.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

BigQuery 라벨 추가

Dataform의 테이블에 BigQuery 라벨을 추가하려면 테이블 정의 SQLX 파일의 config 블록에 있는 bigquery 블록에 라벨을 추가합니다.

테이블 정의 파일에 BigQuery 라벨을 추가하려면 다음 단계를 따르세요.

  1. 개발 작업공간으로 이동합니다.
  2. 파일 창에서 definitions/를 펼칩니다.
  3. SQLX 테이블 정의 파일을 선택합니다.

  4. config 블록에서 다음 형식으로 라벨을 추가합니다.

    bigquery: {
    labels: {
      LABEL1: "VALUE_OF_LABEL1"
    }
  }

    다음을 바꿉니다.

    • LABEL1: 라벨 이름
    • VALUE_OF_LABEL1: 라벨 값

  5. (선택사항): 특수문자가 포함된 이름으로 라벨을 추가하려면 라벨 이름을 따옴표("") 안에 입력합니다.

  6. (선택사항): 형식을 클릭합니다.

다음 코드 샘플은 파티션을 나눈 테이블 정의 SQLX 파일의 bigquery 블록에 추가된 department:shipping 및 cost-center:logistics 라벨을 보여줍니다.

config {
  type: "table",
  bigquery: {
    partitionBy: "DATE(ts)",
    labels: {
      department: "shipping",
      "cost-center": "logistics"
    }
  }
}

SELECT CURRENT_TIMESTAMP() AS ts

다음 단계