문서 메뉴
문서 홈
/
MongoDB Atlas
/

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

이 페이지의 내용

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

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

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

중요

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

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

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

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

  • Atlas 사용자 인터페이스에서 사용자 지정 역할을 만들거나 수정 하는 경우

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

sqlGetSchema

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

sqlSetSchema

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

viewAllHistory

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

outToAzure

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

outToS3

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

storageGetConfig

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

storageSetConfig

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

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

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

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

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

1
2
3
  • 안내를 보려면 Visual Editor 을 클릭합니다.

  • 원시 JSON 을 편집하려면 JSON Editor 를 클릭합니다.

4
5

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을 생성하기 위한 구성 설정에 대해 자세히 알아보려면 다음을 참조하세요.

← 연합 데이터베이스 인스턴스에 대해 쿼리 실행