Data Catalog 리소스는 리전이라고 하는 전 세계 여러 곳에서 호스팅됩니다. 리전은 리소스를 액세스할 수 있는 특정한 지리적 위치로, 자세한 내용은 지역 및 리전을 참조하세요.
네트워크 지연 시간을 줄이기 위해 API 엔드포인트를 사용할 위치와 가까운 리전으로 사용하는 것이 좋습니다. 예를 들어 아시아에서 Data Catalog에 액세스하려는 경우 타이완의 엔드포인트를 사용할 수 있습니다.
지원되는 리전
| 리전 | 리전 엔드포인트 | 지원되는 리소스 | |
|---|---|---|---|
| 미주 | |||
| 몬트리올 | northamerica-northeast1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 토론토 | northamerica-northeast2-datacatalog.googleapis.com |
태그 템플릿, 사용자 작성 항목, 데이터 계보 | |
| 상파울루 | southamerica-east1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 산티아고 | southamerica-west1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 아이오와 | us-central1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 사우스캐롤라이나 | us-east1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 북 버지니아 | us-east4-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 콜럼버스 | us-east5-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 댈러스 | us-south1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 오리건 | us-west1-datacatalog.googleapis.com |
태그 템플릿, 사용자 작성 항목, 데이터 계보 | |
| 로스앤젤레스 | us-west2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 솔트레이크시티 | us-west3-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 라스베이거스 | us-west4-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 유럽 | |||
| 바르샤바 | europe-central2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 핀란드 | europe-north1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 벨기에 | europe-west1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 런던 | europe-west2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 프랑크푸르트 | europe-west3-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 네덜란드 | europe-west4-datacatalog.googleapis.com |
태그 템플릿, 사용자 작성 항목, 데이터 계보 | |
| 취리히 | europe-west6-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 밀라노 | europe-west8-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 파리 | europe-west9-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 베를린 | europe-west10-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 토리노 | europe-west12-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 마드리드 | europe-southwest1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 아시아 태평양 | |||
| 타이완 | asia-east1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 홍콩 | asia-east2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 도쿄 | asia-northeast1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 오사카 | asia-northeast2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 서울 | asia-northeast3-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 뭄바이 | asia-south1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 델리 | asia-south2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 싱가포르 | asia-southeast1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 자카르타 | asia-southeast2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 시드니 | australia-southeast1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 멜버른 | australia-southeast2-datacatalog.googleapis.com |
태그 템플릿, 사용자 작성 항목, 데이터 계보 | |
| 중동 | |||
| 도하 | me-central1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 담맘 | me-central2-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 텔아비브 | me-west1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 | |
| 아프리카 | |||
| 요하네스버그 | africa-south1-datacatalog.googleapis.com |
태그 템플릿, BigQuery, 사용자 작성 항목, 데이터 계보 |
멀티 리전(us, eu)
eu 및 us 같은 멀티 리전은 Data Catalog가 리전 내 어느 곳이든 리소스를 복제하고 제공할 수 있는 특수한 리전입니다.
| 멀티 리전 | 멀티 리전 엔드포인트 | 지원되는 리소스 |
|---|---|---|
| 아시아 | asia-datacatalog.googleapis.com |
태그 템플릿, 사용자 작성 항목, 데이터 계보 |
| 유럽 연합 | eu-datacatalog.googleapis.com |
BigQuery, 태그 템플릿, 사용자 작성 항목, 데이터 계보 |
| 미국 | us-datacatalog.googleapis.com |
BigQuery, 태그 템플릿, 사용자 작성 항목, 데이터 계보 |
BigQuery Omni 리전
| BigQuery Omni 리전 | 리전 엔드포인트 | 지원되는 리소스 | |
|---|---|---|---|
| AWS | |||
| AWS - 미국 동부(북 버지니아) | aws-us-east-1-datacatalog.googleapis.com |
BigQuery(연결 제외), 데이터 계보 | |
| AWS 미국 서부(오리건) | aws-us-west-2-datacatalog.googleapis.com |
BigQuery(연결 제외), 데이터 계보 | |
| AWS - 아시아 태평양(서울) | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery(연결 제외), 데이터 계보 | |
| AWS - 아시아 태평양(시드니) | aws-ap-southeast-2-datacatalog.googleapis.com |
BigQuery(연결 제외), 데이터 계보 | |
| AWS - 유럽(아일랜드) | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery(연결 제외), 데이터 계보 | |
| AWS - 유럽(프랑크푸르트) | aws-eu-central-1-datacatalog.googleapis.com |
BigQuery(연결 제외), 데이터 계보 | |
| Azure | |||
| Azure - 미국 동부 2(버지니아) | azure-eastus2-datacatalog.googleapis.com |
BigQuery(연결 제외), 데이터 계보 | |
| Azure - 미국 서부 2(워싱턴) | azure-westus2-datacatalog.googleapis.com |
데이터 계보 |
리전 API로 리소스 액세스
리소스는 리전 엔드포인트를 사용하여 액세스할 수 있습니다(앞의 지원되는 리전에 나열됨). 클라이언트 라이브러리를 사용하여 엔드포인트를 구성할 수 있습니다.
이전 버전과의 호환성을 위해 리전 API는 몇 가지 제한이 있지만 datacatalog.googleapis.com 엔드포인트에서 계속 지원됩니다(HTTP 배치 지원 및 gRPC 지원참조).
리전 API에는 리전 엔드포인트를 사용하는 것이 좋습니다.
비 리전 API
데이터 애셋은 특정 리전에 위치하지만 Data Catalog의 검색 기능은 전역으로 범위가 지정됩니다. SearchCatalog 및 LookupEntry와 같은 비 리전 API는 모든 리전의 애셋을 반환하며 datacatalog.googleapis.com 엔드포인트로 액세스할 수 있습니다.
HTTP 배치 지원
Data Catalog는 HTTP 배치를 지원하므로 단일 요청에 여러 API 호출을 일괄적으로 요청할 수 있습니다.
리전 API에 HTTP 배치를 사용하는 경우 몇 가지 제약이 있습니다.
- HTTP 일괄 요청에는 같은 리전에 속한 리소스의 API 요청만 포함해야 합니다.
- 리전 API를 일괄 요청할 때는 리전 엔드포인트를 사용해야 합니다.
datacatalog.googleapis.com은 일괄 요청되는 리전 API를 지원하지 않습니다. 리전 및 비 리전 요청은 일괄적으로 처리할 수 없습니다. - 비 리전 종속 API(SearchCatalog 및 LookupEntry)는
datacatalog.googleapis.com엔드포인트를 사용하여 일괄 처리될 수 있습니다.
HTTP 배치 사용 여부를 잘 모르겠다면 다음 안내를 따르세요.
http://datacatalog.googleapis.com/batch와 같이 경로가/batch로 설정된 HTTP 요청을 직접 호출하는지 확인합니다.Google API 클라이언트 라이브러리를 사용하는 경우:
- 자바: BatchRequest를 사용하여 API를 호출합니다.
- Python: BatchHTTP 요청을 사용하여 API를 호출합니다.
- 다른 라이브러리에 비슷한 결합이 존재합니다(라이브러리 특정 문서 참조).
gRPC 지원
리전 API에 gRPC를 사용하려면 리전 엔드포인트를 사용하는 것이 좋습니다.
수동으로 만든 gRPC 라이브러리를 사용하여 datacatalog.googleapis.com 엔드포인트를 호출하는 경우 요청에 locations=<region> 태그가 있는 x-google-request-params 헤더를 지정해야 합니다. gRPC를 내부적으로 사용하는 기존 Google 클라이언트 라이브러리에는 이미 이 기능이 구현되어 있습니다.