대화형 SQL 변환기를 사용하여 쿼리 변환

이 문서에서는 BigQuery 대화형 SQL 변환기를 사용하여 다른 SQL 언어의 쿼리를 GoogleSQL 쿼리로 변환하는 방법을 설명합니다. 대화형 SQL 변환기를 사용하면 워크로드를 BigQuery로 마이그레이션할 때 시간과 노력을 줄일 수 있습니다. 이 문서는 Google Cloud 콘솔에 익숙한 사용자를 대상으로 합니다.

시작하기 전에

Google Cloud CLI 프로젝트가 2022년 2월 15일 이전에 생성된 경우 다음과 같이 BigQuery Migration API를 사용 설정합니다.

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

   BigQuery Migration API로 이동

2. 사용 설정을 클릭합니다.

참고: 2022년 2월 15일 이후에 생성된 프로젝트에는 이 API가 자동으로 사용 설정됩니다.

권한 및 역할

이 섹션에서는 대화형 SQL 변환기를 사용하는 데 필요한 Identity and Access Management(IAM) 권한과 그러한 권한을 부여하는 사전 정의된 IAM 역할에 대해 설명합니다. 이 섹션에서는 추가 변환 구성을 구성하는 데 필요한 권한도 설명합니다.

대화형 SQL 변환기를 사용할 수 있는 권한

대화형 SQL 변환기를 사용하려면 다음 권한이 필요합니다.

• bigquerymigration.translation.translate

다음과 같은 사전 정의된 IAM 역할은 대화형 SQL 변환기를 사용하는 데 필요한 권한을 제공합니다.

• roles/bigquerymigration.translationUser

대화형 SQL 변환기에서 쿼리를 실행하려면 BigQuery에서 쿼리를 실행하는 데 필요한 권한과 동일한 권한이 필요합니다. 예를 들어 테이블을 쿼리하려면 테이블 데이터를 읽을 수 있는 권한이 있어야 합니다. 자세한 내용은 BigQuery 데이터 쿼리를 참조하세요.

추가 변환 구성을 구성할 수 있는 권한

변환 설정의 변환 구성 ID 및 변환 구성 소스 위치 필드를 사용하여 추가 변환 구성을 구성할 수 있습니다. 이러한 변환 구성을 구성하려면 다음 권한이 필요합니다.

• bigquerymigration.workflows.get
• bigquerymigration.workflows.list

사전 정의된 다음 IAM 역할은 추가 변환 구성을 구성하는 데 필요한 권한을 제공합니다.

• roles/bigquerymigration.viewer

BigQuery IAM에 대한 자세한 내용은 IAM으로 액세스 제어를 참조하세요.

지원되는 SQL 언어

BigQuery 대화형 SQL 변환기는 다음 SQL 언어를 GoogleSQL로 변환할 수 있습니다.

• Amazon Redshift SQL
• Apache HiveQL 및 Beeline CLI
• IBM Netezza SQL 및 NZPLSQL
• Teradata 및 Teradata Vantage
  • SQL
  • Basic Teradata Query(BTEQ)
  • Teradata Parallel Transport(TPT)

또한 미리보기에서 다음 SQL 언어 변환이 지원됩니다.

• Apache Spark SQL
• Azure Synapse T-SQL
• MySQL SQL
• Oracle SQL, PL/SQL, Exadata
• PostgreSQL SQL
• Trino 또는 PrestoSQL
• Snowflake SQL
• SQL Server T-SQL
• SQLite
• Vertica SQL

쿼리를 GoogleSQL로 변환

쿼리를 GoogleSQL로 변환하려면 다음 단계를 따르세요.

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

   BigQuery로 이동

2. 편집기 창에서 더보기를 클릭한 다음 변환 설정을 선택합니다.

3. 소스 언어에서 변환할 SQL 언어를 선택합니다.

4. (선택사항) 처리 위치에서 변환 작업을 실행할 위치를 선택합니다. 예를 들어 유럽에 있고 데이터가 위치 경계를 넘어가지 않도록 하려면 eu 리전을 선택합니다.

5. 저장을 클릭합니다.

6. 편집기 창에서 더보기를 클릭한 다음 SQL 변환 사용 설정을 선택합니다.

   편집기 창이 2개의 창으로 분할됩니다.

7. 왼쪽 창에 변환할 쿼리를 입력합니다.

8. 변환을 클릭합니다.

   BigQuery에서 쿼리를 GoogleSQL로 변환하고 오른쪽 창에 표시합니다. 예를 들어 다음 스크린샷은 변환된 Teradata SQL을 보여줍니다.

   

9. 선택사항: 변환된 GoogleSQL 쿼리를 실행하려면 실행을 클릭합니다.

10. 선택사항: SQL 편집기로 돌아가려면 더보기를 클릭한 다음 SQL 변환 사용 중지를 선택합니다.

    편집기 창이 단일 창으로 돌아갑니다.

대화형 변환 작업 성능 향상

미리보기

이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

참고: 이 미리보기 기능과 관련된 의견을 제공하거나 궁금한 점이 있으면 [e-mail]으로 문의하세요.

장기 실행 대화형 변환 작업(예: 대용량 메타데이터 파일 패키지 사용)에서 안정성을 높이고 네트워크 시간 제한 문제를 방지하려면 통합된 변환 API를 사용 설정합니다. 통합된 변환 API는 대화형 및 일괄 변환기를 단일 워크플로로 결합하여 대화형 변환 작업의 효율성과 안정성을 향상시킵니다.

필요한 역할

대화형 변환기와 함께 통합 변환 API를 사용하는 데 필요한 권한을 얻으려면 관리자에게 parent 리소스에 대한 MigrationWorkflow 편집자(roles/bigquerymigration.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 대화형 변환기와 함께 통합 변환 API를 사용하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

대화형 변환기와 함께 통합 변환 API를 사용하려면 다음 권한이 필요합니다.

• bigquerymigration.workflows.create
• bigquerymigration.workflows.get

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

통합 변환 API 사용 설정

대화형 번환기에 대해 통합 변환 API를 사용 설정하려면 통합 변환 API 허용 목록 양식을 작성하세요. 일괄 SQL 변환기와 함께 통합 변환 API를 사용하는 방법에 대한 자세한 내용은 변환 작업 제출의 API 안내를 참조하세요.

추가 구성으로 쿼리 변환

미리보기

이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

일괄 변환 구성 ID를 제공하거나 Cloud Storage 폴더에 저장된 구성 파일을 사용하여 추가 변환 구성으로 대화형 쿼리를 실행할 수 있습니다. 변환 구성에는 변환 품질을 향상시킬 수 있는 소스 데이터베이스의 SQL 객체 메타데이터 또는 객체 매핑 정보가 포함될 수 있습니다. 예를 들어 대화형 SQL 변환 품질을 개선하기 위해 소스 데이터베이스의 DDL 정보 또는 스키마를 포함합니다.

일괄 변환 구성 ID를 제공하여 변환 구성을 지정하려면 다음을 수행합니다.

1. 쿼리 편집기에서 더보기 > 변환 설정을 클릭합니다.

2. 변환 구성 ID 필드에 완료된 BigQuery 일괄 마이그레이션 작업의 동일한 변환 구성을 적용하기 위한 일괄 변환 구성 ID를 제공합니다.

   작업의 일괄 변환 구성 ID를 찾으려면 SQL 변환 페이지에서 일괄 변환 작업을 선택한 후 변환 구성 탭을 클릭합니다. 일괄 변환 구성 ID가 리소스 이름으로 나열됩니다.

3. 저장을 클릭합니다.

변환 구성 소스 파일을 제공하여 변환 구성을 지정하려면 다음을 수행하세요.

1. 쿼리 편집기에서 더보기 > 변환 설정을 클릭합니다.

2. 변환 구성 소스 위치 필드에 Cloud Storage 폴더에 저장된 변환 구성 파일의 경로를 지정합니다.

   BigQuery 대화형 SQL 변환기에서는 변환 메타데이터와 객체 이름 매핑을 포함하는 구성 파일을 지원합니다. Cloud Storage에 파일을 업로드하는 방법에 대한 자세한 내용은 파일 시스템에서 객체 업로드를 참조하세요.

3. 저장을 클릭합니다.

구성 파일 크기 제한

BigQuery 대화형 SQL 변환기에서 변환 구성 파일을 사용하는 경우 압축된 메타데이터 파일 또는 YAML 구성 파일이 50MB보다 작아야 합니다. 파일 크기가 50MB를 초과하면 대화형 변환기는 변환 중에 해당 구성 파일을 건너뛰고 다음과 유사한 오류 메시지를 생성합니다.

CONFIG ERROR: Skip reading file "gs://metadata-file.zip". File size (150,000,000 bytes) exceeds limit (50 MB).

메타데이터 파일 크기를 줄이는 한 가지 방법은 --database 또는 --schema 플래그를 사용해서 변환 입력 쿼리와 관련된 데이터베이스 또는 스키마의 메타데이터만 추출하는 것입니다. 메타데이터 파일을 생성할 때 이러한 플래그를 사용하는 방법은 전역 플래그를 참조하세요.

제한사항

대화형 SQL 변환기에는 변환을 위해 입력한 쿼리에 대한 스키마 정보가 없습니다. 가장 정확한 변환을 보장하기 위해 쿼리 자체 전에 쿼리에 사용된 모든 테이블의 데이터 정의 언어(DDL) 문을 입력합니다. 예를 들어 Amazon Redshift 쿼리 select table1.field1, table2.field1 from table1, table2 where table1.id = table2.id;를 변환하려면 다음 SQL 문을 대화형 SQL 변환기에 입력합니다.

create table schema1.table1 (id int, field1 int, field2 varchar(16));
create table schema1.table2 (id int, field1 varchar(30), field2 date);

select table1.field1, table2.field1
from table1, table2
where table1.id = table2.id;

위치

대화형 SQL 변환기는 다음 처리 위치에서 사용할 수 있습니다.

• us미국(멀티 리전)
• euEU(멀티 리전)
• southamerica-east1(상파울루)
• us-central1(아이오와)
• asia-northeast1(도쿄)
• asia-south1(뭄바이)
• asia-southeast1(싱가포르)
• australia-southeast1(시드니)
• europe-central2(바르샤바)
• europe-north1(핀란드)
• europe-west1(벨기에)
• europe-west2(런던)
• europe-west3(프랑크푸르트)

가격 책정

대화형 SQL 변환기를 사용하는 데에는 요금이 부과되지 않습니다. 그러나 입력 및 출력 파일을 저장하는 데 사용되는 스토리지에는 일반 요금이 발생합니다. 자세한 내용은 스토리지 가격 책정을 참조하세요.

다음 단계

데이터 웨어하우스 마이그레이션의 다음 단계를 자세히 알아보세요.

• 마이그레이션 개요
• 마이그레이션 평가
• 스키마 및 데이터 전송 개요
• 일괄 SQL 변환
• Data Pipelines
• 데이터 보안 및 거버넌스
• 데이터 검증 도구