연합 데이터베이스 인스턴스에 대한 데이터 저장을 정의합니다.

이 페이지의 내용

Data Federation 액세스

권한 작업
연합 데이터베이스 인스턴스 구성 설정 또는 업데이트
연합 데이터베이스 인스턴스 구성 유효성 검사
연합 데이터베이스 인스턴스 구성 조회
와일드카드 컬렉션 생성

연합 데이터베이스 인스턴스 만들기는 JSON 형식으로 스토리지 구성을 만드는 것으로 시작됩니다. 저장소 구성은 데이터 저장소를 정의하고 해당 데이터 저장소를 쿼리 collection에 매핑합니다.

Atlas Data Federation 은 S3 버킷, Azure Blob Storage 컨테이너, Atlas 클러스터, Atlas 온라인 아카이브 및 공개적으로 액세스할 수 있는 URL을 데이터 저장소로 지원합니다. 데이터에 대한 쿼리를 실행 연합 데이터베이스 인스턴스 에서 S3 버킷, Atlas 클러스터 , Atlas Online Archive, HTTP 데이터 저장소에 대한 매핑을 정의해야 합니다.

중요

스토리지 구성의 정보는 MongoDB에서 내부적으로 볼 수 있으며, Atlas Data Federation의 성능을 모니터링하고 개선하기 위해 운영 데이터로 저장됩니다. 구성 시 PII 를 사용하지 않는 것이 좋습니다.

이 페이지에서는 연합 데이터베이스 인스턴스 스토리지 구성을 설정, 업데이트 및 검색하는 데 사용할 수 있는 관리 명령에 대해 설명합니다. 이 섹션의 다른 페이지에서는 다양한 데이터 저장소에 대한 연합 데이터베이스 인스턴스 저장소 구성에서 정의할 수 있는 설정에 대해 설명합니다.

Data Federation 액세스

연합 데이터베이스 인스턴스를 만들 때 에 Atlas Amazon Web Services 계정의 S3 버킷에 대한 읽기 전용 또는 읽기 및 쓰기 액세스 권한을 부여합니다. Atlas 클러스터에 액세스하기 위해 Atlas는 기존 역할 기반 액세스 제어를 사용 합니다. S3 버킷 및 Atlas 클러스터의 데이터를 연합 데이터베이스 인스턴스 및 가상 컬렉션에 매핑하는 데이터 저장소 구성을 보고 편집할 수 있습니다.

권한 작업

권한 조치는 연합 데이터베이스 인스턴스에서 수행할 수 있는 작업을 정의합니다. 다음과 같은 Atlas Data Federation 권한을 부여할 수 있습니다.

Atlas 사용자 인터페이스에서 사용자 지정 역할을 생성하거나 수정할 때
Atlas API에서 사용자 지정 역할을 만들 actions.action 거나 업데이트 할 때 요청 본문 매개변수에서

sqlGetSchema: mongosh를 사용하여 스키마 보기 명령을 사용하여 컬렉션 또는 뷰에 대해 저장된 스키마 를 검색합니다.

sqlSetSchema: mongosh를 사용하여 스키마 편집 명령을 사용하여 컬렉션 또는 뷰에 대한 스키마 를 설정하거나 삭제 합니다.

viewAllHistory: $queryHistory를 사용하여 과거에 실행된 쿼리에 대한 세부 정보를 조회합니다.

outToAzure: 지원되는 연합 데이터베이스 인스턴스 저장소 또는 여러 지원되는 연합 데이터베이스 인스턴스 저장소 $out 중 하나에서 을(를) 사용하여 Azure Blob Storage 컨테이너 에 데이터를 씁니다.

outToS3: $out을(를) 사용하여 지원되는 연합 데이터베이스 인스턴스 저장소 또는 여러 지원되는 연합 데이터베이스 인스턴스 저장소의 데이터를 S3 버킷에 씁니다

outToGCP: $out를 사용하여 지원되는 연합 데이터베이스 인스턴스 저장소 또는 여러 지원되는 연합 데이터베이스 인스턴스 저장소 중 하나에서 Google Cloud Storage 버킷에 데이터를 씁니다.

storageGetConfig: storageGetConfig 명령을 사용하여 연합 데이터베이스 인스턴스 저장 구성을 검색합니다.

storageSetConfig: storageSetConfig 명령을 사용하여 연합 데이터베이스 인스턴스 저장 구성을 설정하거나 업데이트합니다.

연합 데이터베이스 인스턴스 구성 설정 또는 업데이트

연합 데이터베이스 인스턴스에 연결되면 다음 데이터베이스 명령을 사용하여 연합 데이터베이스 인스턴스 구성을 설정하거나 업데이트할 수 있습니다.

use admin
db.runCommand( { "storageSetConfig" : <config> } )

<config>를 연합 데이터베이스 인스턴스의 구성으로 바꿉니다. StorageValidateConfig 명령을 실행하여 연합 데이터베이스 인스턴스 구성을 설정하거나 업데이트하기 전에 구성을 검증할 수 있습니다.

Atlas UI를 통해 스토리지 구성을 설정하거나 업데이트하려면 다음 단계를 따르세요.

MongoDB Atlas에 로그인합니다.

Data Federation 왼쪽 탐색에서 옵션을 선택합니다.

Configuration 연합 데이터베이스 인스턴스 에 대해 를 클릭하고 구성 방법을 선택합니다.

안내를 따라 진행하고자 할 때는 Visual Editor를 클릭합니다.
원시 JSON 을 편집하려면 JSON Editor 를 클릭합니다.

연합 데이터베이스 인스턴스 스토리지 구성을 필요에 따라 변경합니다.

스토리지 구성에서 데이터 저장소를 managed 다음을 수행합니다.

새 데이터 저장소를 추가하려면 Add Data Store 을 클릭합니다. 추가하려면 다음을 수행합니다.
- 3 데이터 저장 에서 연합 데이터베이스 인스턴스 배포의 5 단계를 완료합니다.
- Atlas 데이터 저장소에서 Atlas 연합 데이터베이스 인스턴스 배포의 5~7단계를 따르세요.
- HTTP 데이터 저장 를 사용하려면 연합 데이터베이스 인스턴스 배포의 5 ~ 7 단계를 따르세요.
- Atlas Online Archive 에서 UI 에서 만들기 의 5 및 6 단계를 따르세요.
stores JSON 구성 설정에 해당합니다.
다음을 클릭합니다. 데이터 저장소 이름을 편집할 수 있습니다.
stores.[n].name JSON 구성 설정에 해당합니다.
클릭 을(를) 데이터 저장소와 연결하여 데이터 저장소를 제거합니다.

스토리지 구성에서 managed 데이터베이스를 다음을 수행합니다.

데이터베이스 및 collection을 추가하려면 Create Database 을 클릭합니다.
databases JSON 구성 설정에 해당합니다.
다음을 클릭합니다. 를 클릭하여 데이터베이스 이름을 편집합니다.
databases.[n].name JSON 구성 설정에 해당합니다.
클릭 데이터베이스와 연결된 데이터베이스를 제거합니다.

스토리지 구성에서 collection 및 보기를 managed 다음을 수행합니다.

다음을 클릭합니다. 의 경우:
- collection을 클릭하여 collection 이름을 편집합니다.
  databases.[n].collections.[n].name JSON 구성 설정에 해당합니다.
- 뷰를 클릭하여 뷰 이름과 파이프라인을 편집합니다.
  각각 databases.[n].views.[n].name 및 databases.[n].views.[n].pipeline JSON 구성 설정에 해당합니다.
클릭 와(과) 관련이 있습니다:
- 데이터베이스에 collection을 추가하는 데이터베이스입니다.
  databases.[n].collections JSON 구성 설정에 해당합니다.
- 컬렉션에 대한 뷰 를 추가하는 컬렉션 입니다. 뷰를 만들려면 다음을 지정해야 합니다.
  - 뷰의 이름을 지정합니다.
  - 뷰에 적용할 파이프라인 입니다.
  databases.[n].views JSON 구성 설정에 해당합니다.
클릭 를 클릭하여 collection 또는 뷰를 제거합니다.

stores 및 databases 에 대한 UI 에 표시된 JSON 구성 설정을 편집합니다. 구성 설정에 학습 보려면 연합 데이터베이스 인스턴스에 대한 데이터 저장소 정의를 참조하세요.

Save 연합 데이터베이스 인스턴스 를 생성하려면 를 클릭합니다.

managed 연합 데이터베이스 인스턴스를 사용하여 스토리지 구성을 설정하고 managed 할 수도 있습니다.

연합 데이터베이스 인스턴스 구성 유효성 검사

다음 명령을 실행하여 연합 데이터베이스 인스턴스 구성의 유효성을 검증할 수 있습니다.

use admin
db.runCommand( { "storageValidateConfig" : <config> } )

<config> 을(를) 연합 데이터베이스 인스턴스에 대한 구성으로 바꿉니다.

연합 데이터베이스 인스턴스 구성이 유효한 경우 명령은 다음을 반환합니다.

{ "ok" : 1 }

이 명령은 연합 데이터베이스 인스턴스 스토리지 구성이 유효하지 않은 경우 errs 필드의 오류 목록을 반환합니다.

{
       "ok" : 1,
       "errs" : [
               "<error>",
               "<error>",
               ...
       ]
}

연합 데이터베이스 인스턴스 구성 조회

연합 데이터베이스 인스턴스에 연결되면 다음 데이터베이스 명령을 사용하여 연합 데이터베이스 인스턴스 구성을 검색할 수 있습니다.

use admin
db.runCommand( { "storageGetConfig" : 1 } )

이 명령은 현재 연합 데이터베이스 인스턴스 구성을 반환합니다.

와일드카드 컬렉션 생성

S3 버킷 또는 Atlas cluster의 데이터에 매핑되는 collection 이름을 동적으로 생성할 수 있습니다. 컬렉션 이름을 동적으로 생성하려면 연합 데이터베이스 인스턴스 스토리지 구성에서 컬렉션 이름 설정의 값으로 와일드카드 * 를 지정합니다. 연합 데이터베이스 인스턴스 스토리지 구성에서는 HTTP 또는 HTTPS 데이터 저장소의 데이터에 매핑되는 collection 이름을 동적으로 생성할 수 없습니다.

storageSetConfig 명령을 사용하여 와일드카드(*) 컬렉션을 생성하기 위한 설정을 구성할 수 있습니다.

와일드카드 collection을 생성하기 위한 구성 설정에 대해 자세히 알아보려면 다음을 참조하세요.

돌아가기

쿼리 실행

AWS S3 버킷

중요