SELECT하고 INSERT할 수 있는 테이블 형태의 인터페이스를 제공합니다. Storage Object User IAM 역할이 필요합니다.
이는 s3 테이블 함수의 별칭입니다.
클러스터에 여러 레플리카가 있는 경우, GCS에서도 작동하는 s3Cluster 함수를 대신 사용해 삽입을 병렬화할 수 있습니다.
구문
인수
GCSGoogle XML API의 endpoint는 JSON API와 다르므로 GCS 경로는 다음 포맷이어야 합니다:https://storage.cloud.google.com 형식은 사용할 수 없습니다.
url, format, structure, compression_method는 동일하게 동작하며, 몇 가지 추가 매개변수도 지원합니다:
반환 값
예시
https://storage.googleapis.com/my-test-bucket-768/data.csv의 테이블에서 처음 두 행을 선택하는 예시입니다:
gzip 압축 방식을 사용하는 파일의 경우도 비슷합니다:
사용법
- ‘https://storage.googleapis.com/my-test-bucket-768/some_prefix/some_file_1.csv'
- ‘https://storage.googleapis.com/my-test-bucket-768/some_prefix/some_file_2.csv'
- ‘https://storage.googleapis.com/my-test-bucket-768/some_prefix/some_file_3.csv'
- ‘https://storage.googleapis.com/my-test-bucket-768/some_prefix/some_file_4.csv'
- ‘https://storage.googleapis.com/my-test-bucket-768/another_prefix/some_file_1.csv'
- ‘https://storage.googleapis.com/my-test-bucket-768/another_prefix/some_file_2.csv'
- ‘https://storage.googleapis.com/my-test-bucket-768/another_prefix/some_file_3.csv'
- ‘https://storage.googleapis.com/my-test-bucket-768/another_prefix/some_file_4.csv'
file-000.csv, file-001.csv, … , file-999.csv라는 이름의 파일에 있는 행 수의 총합을 계산합니다:
test-data.csv.gz에 데이터를 삽입합니다:
test-data.csv.gz에 삽입합니다:
my-test-bucket-768 디렉터리의 모든 파일을 재귀적으로 가져옵니다:
my-test-bucket 디렉터리 내 모든 폴더에 있는 test-data.csv.gz 파일을 재귀적으로 탐색하여 데이터를 가져옵니다:
파티션별 쓰기
GCS 테이블에 데이터를 삽입할 때 PARTITION BY 표현식을 지정하면 각 파티션 값별로 별도의 파일이 생성됩니다. 데이터를 파일별로 분할하면 읽기 작업의 효율을 높이는 데 도움이 됩니다.
예시
- 키에 파티션 ID를 사용하면 파일이 각각 따로 생성됩니다:
file_x.csv, file_y.csv, file_z.csv의 3개 파일에 기록됩니다.
- 버킷 이름에 파티션 ID를 사용하면 파일이 서로 다른 버킷에 생성됩니다:
my_bucket_1/file.csv, my_bucket_10/file.csv, my_bucket_20/file.csv의 세 파일에 기록됩니다.