연합 데이터베이스 인스턴스에 대한 데이터 저장 구성

이 페이지에는 연합 데이터베이스 인스턴스 저장 구성을 설정하다, 업데이트 및 조회 데 사용할 수 있는 일반 명령이 포함되어 있습니다. AWS S3 암호화와 같은 특정 데이터 저장 구성에 대해서는 해당 데이터 저장 설명서를 참조하세요.

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

연합 데이터베이스 인스턴스 에 대한 데이터 저장 구성하려면 데이터 저장소를 정의하고 쿼리 할 수 있는 컬렉션에 매핑하는 저장 구성 JSON 파일 만들어야 합니다. MongoDB 다음 데이터 저장소에 대한 연합 데이터베이스 인스턴스 지원 제공합니다.

중요

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

데이터 액세스 유형

연합 데이터베이스 인스턴스 생성할 때 AWS 계정의 AWS 버킷에 대한 다음 유형의 데이터 액세스 중 하나를 Atlas 부여합니다.

읽기 전용 액세스: 데이터를 변경하거나 새 데이터를 추가할 수 없습니다.
읽기 및 쓰기 (write) 액세스: 기존 파일을 업데이트, 파일을 삭제하거나, 저장에 새 데이터를 추가할 수 있습니다.

Atlas cluster에 액세스 위해 Atlas 기존 역할 기반 액세스 제어를 사용합니다. 사용자는 자체 관리형 배포서버에서 사용자 및 역할 관리단계에 따라 자신의 액세스를 보고 편집할 수 있습니다.

권한 작업

권한 조치는 연합 데이터베이스 인스턴스 에서 수행할 수 있는 작업입니다. 다음 중 하나를 통해 권한 조치 를 부여할 수 있습니다.

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

다음 표는 사용 가능한 연합 데이터베이스 인스턴스 권한 조치를 보여줍니다.

명령	설명
`sqlGetSchema`	컬렉션 또는 뷰에 대해 저장된 스키마를 조회합니다. 자세한 내용은 `mongosh`를 사용하여 스키마 조회 를 참조하세요.
`sqlSetSchema`	컬렉션 또는 뷰에 대한 스키마 설정하거나 삭제, 자세한 내용은 `mongosh`를 사용하여 스키마 보기 를 참조하세요.
`viewAllHistory`	$queryHistory를 사용하여 과거에 실행된 쿼리에 대한 세부 정보를 조회합니다.
`outToAzure`	$out 을 사용하여 지원되는 연합 데이터베이스 인스턴스 저장소 또는 여러 지원되는 연합 데이터베이스 인스턴스 저장소 중 하나의 데이터를 Azure Blob Storage 컨테이너에 씁니다.
`outToS3`	$out 을 사용하여 지원되는 연합 데이터베이스 인스턴스 저장 또는 여러 지원되는 연합 데이터베이스 인스턴스 저장의 데이터를 S3 버킷에 쓰기 (write) 합니다.
`outToGCP`	$out 을 사용하여 지원되는 연합 데이터베이스 인스턴스 저장 또는 여러 지원되는 연합 데이터베이스 인스턴스 저장에서 Google Cloud 저장 버킷에 데이터를 씁니다.
`storageGetConfig`	storageGetConfig 명령을 사용하여 연합 데이터베이스 인스턴스 저장 구성 을 조회합니다.
`storageSetConfig`	storageSetConfig 명령을 사용하여 연합 데이터베이스 인스턴스 저장 구성을 설정하거나 업데이트 .

설정 파일 조회

연합 데이터베이스 인스턴스 설정 파일을 조회 하려면 인스턴스 에 연결하고 다음 명령을 사용합니다.

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

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

설정 파일 유효성 검사

연합 데이터베이스 인스턴스 구성의 유효성을 검사하려면 인스턴스 에 연결하고 다음 명령을 사용합니다.

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

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

구성이 유효하면 명령은 다음과 같은 답변 반환합니다.

{ "ok" : 1 }

구성이 유효하지 않은 경우 명령은 errs 필드 의 오류 목록을 반환합니다.

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

연합 데이터베이스 인스턴스 구성 업데이트

연합 데이터베이스 인스턴스 구성을 업데이트 하려면 인스턴스 에 연결하여 다음 명령을 사용합니다.

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

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

팁

변경 사항을 적용하기 전에 MongoDB 연합 데이터베이스 인스턴스 구성의 유효성을 검사할 것을 권장합니다.

연합 데이터베이스 인스턴스 구성 데이터 저장, 데이터 소스, 데이터베이스, 컬렉션 및 뷰를 업데이트 하려면 다음 단계를 따르세요.

MongoDB Atlas 에 로그인

왼쪽의 Services 에서 Data Federation 옵션을 선택합니다.

연합 데이터베이스 인스턴스 이름 옆의 Configuration 버튼을 클릭합니다

오른쪽 상단 모서리에서 원하는 구성 인터페이스 방법을 선택합니다.

시각적 인터페이스의 경우 Visual를 클릭합니다.
JSON 파일에서 직접 편집하려면 JSON Editor를 클릭합니다.

연합 데이터베이스 인스턴스 저장 구성을 변경합니다.

데이터 소스 관리

추가 데이터 소스 추가

stores JSON 구성 설정에 해당합니다.

Add Data Store Sources를 클릭합니다.
구성하려는 데이터 소스 제공자를 선택합니다: - AWS S3의 경우, 연합 데이터베이스 인스턴스 데이터 저장소 배포의 5 단계를 계속 진행합니다. - Google Cloud의 경우 연합 데이터베이스 인스턴스 데이터 저장소 배포의 7 단계를 계속 진행합니다. - Azure의 경우 연합 데이터베이스 인스턴스 데이터 저장소 배포의 7 단계를 계속 진행합니다. - Atlas 클러스터의 경우 연합 데이터베이스 인스턴스 데이터 저장 배포의 7 단계를 계속 진행합니다. - HTTP 데이터 저장의 경우 연합 데이터베이스 인스턴스 데이터 저장 배포의 7 단계를 계속 진행합니다. - Atlas Online Archive 의 경우 연합 데이터베이스 인스턴스 데이터 저장소 배포의 7 단계를 계속 진행합니다.

데이터 소스 이름 편집

stores.[n].name JSON 구성 설정에 해당합니다.

왼쪽 목록에서 데이터 저장 소스를 선택합니다.
저장 이름 아이콘을 클릭합니다.
데이터 저장 이름 필드에서 현재 이름을 변경합니다.
완료를 클릭합니다.

데이터 소스 삭제

왼쪽 목록에서 데이터 저장 소스를 선택합니다.
이 스토어 삭제 아이콘을 클릭합니다.
삭제 버튼을 클릭합니다.

데이터베이스 관리

새 데이터베이스 만들기

databases JSON 구성 설정에 해당합니다.

오른쪽 상단 모서리에 있는 데이터베이스 추가 버튼을 클릭합니다.
데이터베이스 이름 필드 입력합니다.
컬렉션 이름 필드 입력합니다.
만들기 버튼을 클릭합니다.

데이터베이스 이름 편집

databases.[n].name JSON 구성 설정에 해당합니다.

목록에서 데이터베이스를 선택합니다.
데이터베이스 이름 편집 아이콘을 클릭합니다.
데이터베이스 이름을 업데이트합니다.
완료 버튼을 클릭합니다.

데이터베이스 삭제

목록에서 데이터베이스를 선택합니다.
이 데이터베이스 삭제 아이콘을 클릭합니다.
삭제 버튼을 클릭합니다.

컬렉션 관리

데이터베이스에 새 컬렉션 만들기

databases.[n].collections JSON 구성 설정에 해당합니다.

컬렉션을 생성하려는 데이터베이스를 선택합니다.
컬렉션 추가 아이콘을 클릭합니다.
컬렉션 이름 필드 입력합니다.
만들기 버튼을 클릭합니다.

컬렉션 이름 편집

databases.[n].collections.[n].name JSON 구성 설정에 해당합니다.

목록에서 컬렉션 선택
컬렉션 이름 편집 아이콘을 클릭합니다.
컬렉션 이름 필드에서 현재 이름을 새 이름으로 변경합니다.
만들기 버튼을 클릭합니다.

컬렉션 삭제

목록에서 컬렉션 선택
이 컬렉션 삭제 아이콘을 클릭합니다.
삭제 버튼을 클릭합니다.

조회수 관리

컬렉션에 새 뷰 만들기

databases.[n].views JSON 구성 설정에 해당합니다.

뷰를 만들려는 컬렉션을 선택합니다.
보기 추가 아이콘을 클릭합니다.
뷰 이름 필드 입력합니다.
manual:`파이프라인 </core/aggregation-pipeline/>` 필드를 채웁니다.
만들기 버튼을 클릭합니다.

뷰 이름 또는 파이프라인 편집

각각 databases.[n].views.[n].name 및 databases.[n].views.[n].pipeline JSON 구성 설정에 해당합니다.

컬렉션에서 보기 선택
뷰 이름 편집 아이콘을 클릭합니다.
View Name(보기 이름) 필드에서 현재 이름을 새 이름으로 변경합니다.
새 파이프라인의 파이프라인 필드에서 현재 파이프라인 변경합니다.
저장 버튼을 클릭합니다.

뷰 삭제

목록에서 보기를 선택합니다.
이 보기 삭제 아이콘을 클릭합니다.
삭제 버튼을 클릭합니다.

JSON 설정 파일 객체를 편집하여 stores, databases 또는 views를 추가, 생성 또는 제거.

특정 데이터 저장 제공자의 구성 설정에 대해 자세히 알아보려면 해당 제공자의 설정 파일 페이지를 참조하세요.

MongoDB Shell (mongosh)을 사용하여 저장 구성을 설정하다 하고 관리 방법을 학습 보려면 연합 데이터베이스 인스턴스 관리페이지를 참조하세요.

와일드카드 컬렉션 생성

중요

와일드카드 컬렉션 함수는 오직 AWS S3 및 Atlas 클러스터의 데이터 소스에만 사용할 수 있습니다.

AWS S3 또는 Atlas 클러스터의 데이터 소스를 사용하는 경우 데이터에 매핑되는 컬렉션 이름을 동적으로 설정할 수 있습니다. 컬렉션 이름을 생성하려면 연합 데이터베이스 인스턴스 저장 구성의 컬렉션 이름 설정 값으로 와일드카드 기호 * 를 지정합니다.

팁

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

돌아가기

고급 사용자 구성

데이터 저장 배포