연합 데이터베이스 인스턴스 배포
이 페이지의 내용
이 페이지에서는 Atlas cluster의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스를 배포하는 방법을 설명합니다.
필요한 액세스 권한
연합 데이터베이스 인스턴스 를 배포 하려면 프로젝트 에 대한 Project Owner
액세스 이 있어야 합니다. Organization Owner
액세스 이 있는 사용자는 연합 데이터베이스 인스턴스 를 배포하기 전에 프로젝트 에 자신을 Project Owner
으)로 추가해야 합니다.
전제 조건
시작하기 전에 다음을 수행해야 합니다.
아직 계정이 없는 경우 MongoDB Atlas 계정을 만듭니다.
Atlas Cluster 가 아직 없는 경우 생성합니다. Atlas Data Federation은 Amazon Web Services, Azure 또는 GCP에 배포된 Atlas cluster를 지원합니다.
참고
Atlas cluster를 데이터 저장소로 사용하려면 연합 데이터베이스 인스턴스와 동일한 프로젝트에 배포해야 합니다.
아직 데이터를 추가하지 않았다면 Atlas cluster에 있는 collection 중 하나 이상에 데이터를 추가하세요.
절차
Atlas CLI를 사용하여 새 Data Federation 데이터베이스를 생성하려면 다음 명령을 실행합니다.
atlas dataFederation create <name> [options]
명령 구문 및 매개변수에 Atlas CLI 학습 보려면 dataFederation create Atlas 에 대한 설명서를 참조하세요.
Atlas Data Federation 이 연합 데이터베이스 인스턴스 에 대한 쿼리를 프로세스 할 cloud 제공자 를 선택합니다.
Amazon Web Services , Azure 또는 Google Cloud Platform 을 선택할 수 Amazon Web Services Azure있습니다.Google Cloud Platform 연합 데이터베이스 인스턴스 가 생성되면 Atlas Data Federation 이 쿼리를 처리하는 cloud 제공자 를 변경할 수 없습니다.
Atlas cluster에서 데이터를 쿼리하려는 경우, cluster의 클라우드 공급자와 동일한 클라우드 공급자를 선택하는 것이 좋습니다. Amazon Web Services S3 또는 Azure Blob Storage와 같은 객체 스토리지의 데이터를 쿼리하려면 연합 데이터베이스 인스턴스에 대해 객체 스토리지를 위한 cloud와 동일한 cloud를 선택해야 합니다.
데이터 저장소를 지정합니다.
Data Sources 섹션에서 연합 데이터베이스 인스턴스의 데이터 세트를 선택합니다.
Add Data Sources 을 클릭하여 데이터 저장소를 선택합니다.
데이터 소스를 지정합니다.
Atlas Cluster 를 선택하여 Atlas cluster의 데이터에 대한 연합 데이터베이스 인스턴스를 구성합니다.
stores.[n].provider
JSON 구성 설정에 해당합니다.Provide Namespaces in this project 섹션에서 데이터 저장소로 사용할 Atlas cluster를 선택합니다.
stores.[n].clusterName
JSON 구성 설정에 해당합니다.데이터베이스를 확장하고 연합 데이터베이스 인스턴스에 추가하려는 컬렉션을 선택합니다.
데이터베이스 및 컬렉션을 필터하다 하려면 Search database or collection 필드 에 텍스트를 입력합니다. 대화 상자에는 검색 기준과 일치하는 이름을 가진 데이터베이스 및 컬렉션만 표시됩니다.
databases.[n].collections.[n].dataSources.[n].database
및databases.[n].collections.[n].dataSources.[n].collection
JSON 구성 설정에 해당합니다.선택 사항. 섹션을 확장하여 Cluster Read Preference 설정을 지정합니다.
stores.[n].readPreference
에 해당합니다.필드 이름설명Read Preference Mode
읽기 요청을 라우팅할 복제본 세트 멤버를 지정합니다. 드롭다운에서 다음 중 하나를 선택할 수 있습니다.
primary
- 모든 읽기 요청을 복제본 세트 프라이머리로 라우팅합니다.primaryPreferred
-primary
를 사용할 수 없는 경우에만 모든 읽기 요청을 복제본 세트 프라이머리 및 세컨더리 멤버로 라우팅합니다.secondary
- 모든 읽기 요청을 복제본 세트의 세컨더리 멤버로 라우팅합니다.secondaryPreferred
-secondary
멤버를 사용할 수 없는 경우에만 모든 읽기 요청을 복제본 세트 의 세컨더리 멤버와 샤딩된 클러스터의 프라이머리 멤버로 라우팅합니다.nearest
- 멤버가 프라이머리 멤버인지 세컨더리멤버인지에 관계없이 모든 읽기 요청을 임의의 적격 복제본 세트 멤버로 라우팅합니다.
Atlas cluster를 스토어로 추가하는 경우 기본값은
secondary
입니다.연합 데이터베이스 인스턴스 저장 구성에서 아무것도 설정하다 하지 않은 경우 기본값 은
nearest
입니다. 학습 내용은 읽기 설정 모드 를 참조하세요.stores.[n].readPreference.mode
에 해당합니다.TagSets
읽기 요청을 라우팅하려는 복제본 세트 멤버의 이름 및 값 쌍이 포함된 태그 또는 태그를 지정하다 사양 문서의 목록을 지정합니다. 학습 내용은 읽기 설정 태그 세트를 참조하세요.
Maxstaleness Seconds
세컨더리에서 읽기에 대한 최대 복제 지연 또는 '비활성'을 지정합니다. 학습 내용은 읽기 설정 maxStalenessSeconds를 참조하세요.
Next를 클릭합니다.
가상 데이터베이스, 컬렉션 및 뷰를 생성하고 데이터베이스, 컬렉션 및 뷰를 데이터 저장소에 매핑합니다.
(선택 사항) 다음을 클릭합니다. 의 경우:
데이터베이스를 클릭하여 데이터베이스 이름을 편집합니다. 기본값은
VirtualDatabase[n]
입니다.databases.[n].name
JSON 구성 설정에 해당합니다.컬렉션을 클릭하여 컬렉션 이름을 편집합니다. 기본값은
VirtualCollection[n]
입니다.databases.[n].collections.[n].name
JSON 구성 설정에 해당합니다.보기 이름을 편집하려면 보기를 클릭합니다.
다음을 클릭할 수 있습니다.
Add Database 데이터베이스 및 컬렉션을 추가합니다.
데이터베이스에 컬렉션을 추가하기 위해 데이터베이스와 연결됩니다.
을(를) 클릭하여 컬렉션 에 대한 뷰 를 추가 컬렉션. 뷰를 만들려면 다음을 지정해야 합니다.
뷰의 이름을 지정합니다.
뷰에 적용할 파이프라인 입니다.
뷰 정의 파이프라인은
$out
또는$merge
단계를 포함할 수 없습니다. 뷰 정의에$lookup
또는$facet
와 같은 중첩된 파이프라인 단계가 포함된 경우 이 제한은 해당 중첩된 파이프라인에도 적용됩니다.
뷰에 학습 보려면 다음을 참조하세요.
데이터베이스, 컬렉션 또는 뷰와 연결된 항목을 제거합니다.
Data Sources 섹션의 드롭다운에서 Atlas Cluster 를 선택합니다.
데이터 저장소를 드래그 앤 드롭하여 컬렉션과 매핑합니다.
databases.[n].collections.[n].dataSources
JSON 구성 설정에 해당합니다.
Atlas cluster 데이터 저장 의 구성은 다음과 유사해야 합니다.
1 { 2 "stores" : [ 3 { 4 "name" : "<string>", 5 "provider": "<string>", 6 "clusterName": "<string>", 7 "projectId": "<string>", 8 "readPreference": { 9 "mode": "<string>", 10 "tagSets": [ 11 [{"name": "<string>", "value": "<string>"},...], 12 ... 13 ], 14 "maxStalenessSeconds": <int> 15 } 16 } 17 ], 18 "databases" : [ 19 { 20 "name" : "<string>", 21 "collections" : [ 22 { 23 "name" : "<string>", 24 "dataSources" : [ 25 { 26 "storeName" : "<string>", 27 "database" : "<string>", 28 "databaseRegex": "<string>", 29 "collection" : "<string>", 30 "collectionRegex" : "<string>", 31 "provenanceFieldName": "<string>" 32 } 33 ] 34 } 35 ], 36 "views" : [ 37 { 38 "name" : "<string>", 39 "source" : "<string>", 40 "pipeline" : "<string>" 41 } 42 ] 43 } 44 ] 45 }
이러한 구성 설정에 학습 보려면 연합 데이터베이스 인스턴스에 대한 데이터 저장소 정의를 참조하세요.
Atlas 데이터 저장 를 정의합니다.
stores
에 대한 UI 에 표시된 JSON 구성 설정을 편집합니다.stores
구성 설정은 다음과 유사해야 합니다."stores" : [ { "name" : "<string>", "provider" : "<string>", "clusterName" : "<string>", "projectId": "<string>" "readPreference": { "mode": "<string>", "tagSets": [ [{"name": "<string>", "value": "<string>"},...], ... ], "maxStalenessSeconds": <int> }, "readConcern": { "level": "<string>" } } ] 이러한 구성 설정에 학습 보려면
stores
를 참조하세요.연합 데이터베이스 인스턴스 가상 데이터베이스, 컬렉션 및 뷰를 정의합니다.
databases
에 대한 UI 에 표시된 JSON 구성 설정을 편집합니다.databases
구성 설정은 다음과 유사해야 합니다."databases" : [ { "name" : "<string>", "collections" : [ { "name" : "<string>", "dataSources" : [ { "storeName" : "<string>", "database" : "<string>", "databaseRegex": "<string>", "collection" : "<string>", "collectionRegex" : "<string>", "provenanceFieldName": "<string>" } ] } ] } ] 이러한 구성 설정에 학습 보려면
databases
를 참조하세요.