/ /

관리

구성 관리

Docs Home

개발

데이터 페더레이션

관리

구성 관리

`createStore`

createStore 명령은 연합 데이터베이스 인스턴스 스토리지 구성에 저장소를 만듭니다. 데이터 소스에 대한 연합 데이터베이스 인스턴스 저장소를 만드는 방법에 대해 자세히 알아보려면 아래 탭을 클릭하세요.

이 탭 에는 AWS S3 버킷의 데이터에 대한 연합 데이터베이스 인스턴스 저장 생성하기 위한 구문과 매개변수가 포함되어 있습니다.

중요

Atlas Data Federation 은 다양한 cloud 제공자 간의 연합 쿼리를 지원 하지 않습니다. 단일 cloud 제공자 의 매장에 매핑되는 연합 데이터베이스 인스턴스만 생성할 수 있습니다.

구문

db.runCommand({ createStore: <store-name>, provider: <storage-provider>, region: <region-name>, bucket: <bucket-name>, additionalStorageClasses: [ <storage-classes> ], delimiter: <delimiter>, public: true|false })

db.runCommand({ createStore: <store-name>, provider: <storage-provider>, region: <region-name>, serviceURL: <service-account-URL>, containerName: <storage-container-name>, delimiter: <delimiter>, public: true|false })

db.runCommand({ createStore: <store-name>, provider: <storage-provider>, region: <region-name>, bucket: <bucket-name>, delimiter: <delimiter>, prefix: <prefix> })

db.runCommand({ createStore: <store-name>, provider: <storage-provider>, clusterName: <cluster-name>, projectId: <project-id>, readPreference: {mode: <read-preference-mode>, tagSets: [[{name: <name>, value: <value>},...],...], maxStalenessSeconds: <number-of-seconds>}, readConcern: {level: <level>} })

db.runCommand({ createStore: <store-name>, provider: <storage-provider>, allowInsecure: true|false, urls: [ <url> ], defaultFormat: <file-extension> })

db.runCommand({ createStore: <store-name>, provider: "dls:aws", region: <online-archive-region> })

매개변수

Parameter	유형	설명	필수 사항입니다.
`createStore`	문자열	새 연합 데이터베이스 인스턴스 저장소의 이름입니다. 연합 데이터베이스 인스턴스 저장소 이름은 고유해야 합니다.	네
`provider`	문자열	데이터가 저장되는 서비스의 이름입니다. 값은 다음 중 하나일 수 있습니다. `s3` AWS S3 버킷의 경우. `azure` Azure Blob Storage container의 경우. `atlas` Atlas cluster 의 경우. `http` 공개적으로 액세스할 수 있는 URL에 호스팅된 파일의 경우 `dls:<subtype>` 온라인 아카이브의 경우. Atlas Data Federation 은 다음 하위 유형을 지원합니다. `aws` - AWS에 저장된 데이터의 경우. 값은 `dls:aws`이어야 합니다. `azure` - Azure 에 저장된 데이터의 경우. 값은 `dls:azure`이어야 합니다.	네

`region`	문자열	`bucket`가 호스팅되는 리전입니다. 유효한 리전 이름 목록은 Amazon Web Services (AWS)를 참조하세요.	네
`bucket`	문자열	데이터가 저장되는 버킷의 이름입니다. Data Federation AWS IAM 자격 증명 사용하여 액세스 할 수 있는 S3 버킷의 이름과 정확히 일치해야 합니다.	네
`additionalStorageClasses`	문자열 배열	AWS S3 저장 클래스의 배열입니다. Atlas Data Federation 쿼리 결과에 이러한 저장 클래스의 파일을 포함합니다. 유효한 값은 다음과 같습니다. `INTELLIGENT_TIERING` 지능형 계층화 저장 클래스에 파일을 포함합니다. `STANDARD_IA` Standard-Infrequent Access 저장 클래스에 파일을 포함합니다. 표준 저장 클래스의 파일은 기본값 으로 지원됩니다.	no
`delimiter`	문자열	연합 데이터베이스 인스턴스 저장소에서 경로 세그먼트를 구분하는 데 사용되는 문자입니다. 생략하면 기본값은 `"/"` 입니다.	no
`public`	부울	버킷의 공개 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. `true` AWS IAM 역할 사용하여 버킷에 액세스 하지 않도록 합니다. `false` 버킷에 액세스 하려면 AWS IAM 역할 요구합니다. 생략하는 경우 기본값은 `false`입니다.	no

Parameter	유형	설명	필수 사항입니다.
`createStore`	문자열	새 연합 데이터베이스 인스턴스 저장소의 이름입니다. 연합 데이터베이스 인스턴스 저장소 이름은 고유해야 합니다.	네
`provider`	문자열	데이터가 저장되는 서비스의 이름입니다. 값은 다음 중 하나일 수 있습니다. `s3` AWS S3 버킷의 경우. `azure` Azure Blob Storage container의 경우. `atlas` Atlas cluster 의 경우. `http` 공개적으로 액세스할 수 있는 URL에 호스팅된 파일의 경우 `dls:<subtype>` 온라인 아카이브의 경우. Atlas Data Federation 은 다음 하위 유형을 지원합니다. `aws` - AWS에 저장된 데이터의 경우. 값은 `dls:aws`이어야 합니다. `azure` - Azure 에 저장된 데이터의 경우. 값은 `dls:azure`이어야 합니다.	네

region

문자열

컨테이너 호스팅되는 리전입니다. 유효한 리전 이름 목록은 Microsoft Azure 참조하세요.

네

bucket

문자열

블롭 컨테이너가 포함된 Azure Blob Storage 계정의URL . 예시 들면 다음과 같습니다.

https://<azure-storage-account-name>.blob.core.windows.net/

네

containerName

문자열

파일이 포함된 Azure Blob Storage 컨테이너 의 이름입니다. 자세한 내용은 컨테이너 명명 및 참조에 대한 Azure 설명서를 참조하세요.

네

delimiter

문자열

연합 데이터베이스 인스턴스 저장 에서 경로 세그먼트를 구분하는 데 사용되는 문자입니다. 생략하면 기본값은 "/" 입니다.

public

부울

Azure Blob Storage 컨테이너 의 공개 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.

true Azure 서비스 주체를 사용하여 버킷에 액세스 하지 않도록 합니다.
false 버킷에 액세스 있도록 Azure 서비스 주체를 요구합니다.

생략하는 경우 기본값은 false입니다.

Parameter	유형	설명	필수 사항입니다.
`createStore`	문자열	새 연합 데이터베이스 인스턴스 저장소의 이름입니다. 연합 데이터베이스 인스턴스 저장소 이름은 고유해야 합니다.	네
`provider`	문자열	데이터가 저장되는 서비스의 이름입니다. 값은 다음 중 하나일 수 있습니다. `s3` AWS S3 버킷의 경우. `azure` Azure Blob Storage container의 경우. `atlas` Atlas cluster 의 경우. `http` 공개적으로 액세스할 수 있는 URL에 호스팅된 파일의 경우 `dls:<subtype>` 온라인 아카이브의 경우. Atlas Data Federation 은 다음 하위 유형을 지원합니다. `aws` - AWS에 저장된 데이터의 경우. 값은 `dls:aws`이어야 합니다. `azure` - Azure 에 저장된 데이터의 경우. 값은 `dls:azure`이어야 합니다.	네

region

문자열

bucket가 호스팅되는 리전입니다. 유효한 리전 이름 목록은 Google Cloud Platform (GCP)을 참조하세요.

네

bucket

문자열

데이터가 저장되는 버킷의 이름입니다. Data Federation 구성된 Google Cloud IAM 자격 증명 사용하여 액세스 할 수 있는 Google Cloud Storage 버킷의 이름과 정확히 일치해야 합니다.

네

delimiter

문자열

연합 데이터베이스 인스턴스 저장소에서 경로 세그먼트를 구분하는 데 사용되는 문자입니다. 생략하면 기본값은 "/" 입니다.

prefix

부울

Google Cloud Platform 스토리지 버킷에서 파일을 검색할 때 접두사 Atlas Data Federation 이 적용됩니다.Atlas Data Federation Google Cloud Platform 예를 예시 다음과 같은 구조의 Google Cloud Platform Google Cloud Platform Storage 버킷 을 가정해 보겠습니다.metrics

metrics
  |--hardware
  |--software
    |--computed

연합 데이터베이스 인스턴스 저장 는 databases.[n].collections.[n].dataSources.[n].path 에 prefix 값을 추가하여 수집할 파일의 전체 경로를 만듭니다. prefix 를 /software 로 설정하면 연합 데이터베이스 인스턴스 를 사용하는 모든 databases 객체가 /software 의 하위 경로로만 제한됩니다.

기본값은 Google Cloud Platform 모든 파일을 검색하는 Google Cloud Platform 스토리지 버킷의 루트입니다.

Parameter	유형	설명	필수 사항입니다.
`createStore`	문자열	새 연합 데이터베이스 인스턴스 저장소의 이름입니다. 연합 데이터베이스 인스턴스 저장소 이름은 고유해야 합니다.	네
`provider`	문자열	데이터가 저장되는 서비스의 이름입니다. 값은 다음 중 하나일 수 있습니다. `s3` AWS S3 버킷의 경우. `azure` Azure Blob Storage container의 경우. `atlas` Atlas cluster 의 경우. `http` 공개적으로 액세스할 수 있는 URL에 호스팅된 파일의 경우 `dls:<subtype>` 온라인 아카이브의 경우. Atlas Data Federation 은 다음 하위 유형을 지원합니다. `aws` - AWS에 저장된 데이터의 경우. 값은 `dls:aws`이어야 합니다. `azure` - Azure 에 저장된 데이터의 경우. 값은 `dls:azure`이어야 합니다.	네

`clusterName`	문자열	저장 의 기반이 되는 Atlas cluster 의 이름입니다.	네
`projectId`	문자열	Atlas cluster 포함된 프로젝트 의 고유 식별자입니다. Atlas Data Federation 연합 데이터베이스 인스턴스 존재하는 프로젝트 의 `projectId` 만 지원합니다. 지정하지 않으면 Atlas Data Federation 클러스터 연합 데이터베이스 인스턴스 와 동일한 프로젝트 에 있다고 가정합니다.	no
`readPreference`	문서	클러스터 읽기 설정 (read preference)- 읽기 요청을 클러스터 로 라우팅하는 방법을 설명합니다.	no
`readPreference` `.mode`	문자열	읽기 요청을 라우팅할 복제본 세트 멤버를 지정하는읽기 설정 모드 입니다. 값은 다음 중 하나일 수 있습니다. `primary` - 모든 읽기 요청을 복제본 세트 프라이머리 로 라우팅합니다. `primaryPreferred` - `primary`을 사용할 수 없는 경우에만 모든 읽기 요청을 복제본 세트 프라이머리 및 세컨더리 멤버로 라우팅합니다. `secondary` - 모든 읽기 요청을 복제본 세트 의 세컨더리 멤버로 라우팅합니다. `secondaryPreferred` - `secondary` 멤버를 사용할 수 없는 경우에만 모든 읽기 요청을 복제본 세트 의 세컨더리 멤버와 샤딩된 클러스터의 프라이머리 로 라우팅합니다. `nearest` - 멤버가 프라이머리 세컨더리 멤버인지 세컨더리 멤버인지에 관계없이 모든 읽기 요청을 임의의 적격 복제본 세트 멤버로 라우팅합니다.	no
`readPreference` `.tagSets`	문자열 배열	복제본 세트 멤버에 대한 이름 및 값 쌍이 포함된 태그를 지정하다 세트 또는 태그를 지정하다 사양 문서의 배열입니다. 지정된 경우 Atlas Data Federation 지정된 태그와 연결된 복제본 세트 멤버로 읽기 요청을 라우팅합니다. 자세한 학습 은 읽기 설정 태그 세트를 참조하세요. Atlas Data Federation 은 샤딩된 클러스터에 대해 이 매개 변수를 지원 하지 않습니다.	no
`readPreference` `.maxStalenessSeconds`	int	세컨더리에서 읽기에 대한 최대 복제 지연 또는 'staleness'입니다. `maxStalenessSeconds`에 대해 자세히 학습 읽기 설정 maxStalenessSeconds를 참조하세요.	no

Parameter	유형	설명	필수 사항입니다.
`createStore`	문자열	새 연합 데이터베이스 인스턴스 저장소의 이름입니다. 연합 데이터베이스 인스턴스 저장소 이름은 고유해야 합니다.	네
`provider`	문자열	데이터가 저장되는 서비스의 이름입니다. 값은 다음 중 하나일 수 있습니다. `s3` AWS S3 버킷의 경우. `azure` Azure Blob Storage container의 경우. `atlas` Atlas cluster 의 경우. `http` 공개적으로 액세스할 수 있는 URL에 호스팅된 파일의 경우 `dls:<subtype>` 온라인 아카이브의 경우. Atlas Data Federation 은 다음 하위 유형을 지원합니다. `aws` - AWS에 저장된 데이터의 경우. 값은 `dls:aws`이어야 합니다. `azure` - Azure 에 저장된 데이터의 경우. 값은 `dls:azure`이어야 합니다.	네

`allowInsecure`	부울	지정된 URL체계의 유효성을 검사합니다. 값은 다음 중 하나일 수 있습니다. `true` 안전하지 않은 HTTP 체계 허용 `false` 보안 HTTPS 체계만 허용(기본값) true(참)인 경우 Atlas Data Federation: 서버의 인증서 체인과 호스트 이름을 확인하지 않습니다. 서버에서 제공하는 모든 호스트 이름을 가진 모든 인증서를 수락합니다. 경고: 이 값을 `true` 로 설정하다 하면 데이터가 중간자(man-in-the-middle) 공격에 취약해져 데이터의 기밀성과 무결성이 손상될 수 있습니다. Atlas Data Federation 을 테스트하고 시작하는 경우에만 이 값을 `true` 로 설정합니다. 생략하는 경우 기본값은 `false`입니다.	no
`urls`	문자열 배열 또는 빈 배열	공개적으로 액세스할 수 있는 하나 이상의 URL입니다. 인증 이 필요한 URL은 지정할 수 없습니다.	no
`defaultFormat`	문자열	연합 데이터베이스 인스턴스 저장소를 쿼리하는 동안 확장자가 없는 파일을 발견할 경우 Data Federation이 기본값으로 사용할 형식입니다. 유효한 값은 다음과 같습니다. `.json`, `.json.gz`, `.bson`, `.bson.gz`, `.avro`, `.avro.gz`, `.orc`, `.tsv`, `.tsv.gz`, `.csv`, `.csv.gz`, `.parquet` 이를 생략할 경우 Data Federation은 일부 파일 바이트를 처리하여 파일 형식을 감지하려고 시도합니다. 포함된 경우 지정된 형식은 저장 의 URL 에만 적용됩니다.	no

Parameter	유형	설명	필수 사항입니다.
`createStore`	문자열	새 연합 데이터베이스 인스턴스 저장소의 이름입니다. 연합 데이터베이스 인스턴스 저장소 이름은 고유해야 합니다.	네
`provider`	문자열	데이터가 저장되는 서비스의 이름입니다. 값은 다음 중 하나일 수 있습니다. `s3` AWS S3 버킷의 경우. `azure` Azure Blob Storage container의 경우. `atlas` Atlas cluster 의 경우. `http` 공개적으로 액세스할 수 있는 URL에 호스팅된 파일의 경우 `dls:<subtype>` 온라인 아카이브의 경우. Atlas Data Federation 은 다음 하위 유형을 지원합니다. `aws` - AWS에 저장된 데이터의 경우. 값은 `dls:aws`이어야 합니다. `azure` - Azure 에 저장된 데이터의 경우. 값은 `dls:azure`이어야 합니다.	네

region

문자열

온라인 아카이브의 리전입니다. 서로 다른 리전에 여러 아카이브가 있는 경우 각 리전 의 저장 를 추가하여 해당 리전 의 데이터를 연합 데이터베이스 인스턴스의 가상 데이터베이스 및 컬렉션에 매핑해야 합니다.

네

출력

명령이 성공하면 다음 출력이 인쇄됩니다. 명령이 실패할 경우 오류 문제 해결에서 권장 해결 방법을 확인하세요.

{
  "ok": 1,
  "store": {
    "name": "<store-name>",
    "region": "<region-name>",
    "bucket": "<bucket-name>",
    "additionalStorageClasses": ["<storage-classes>"]
    "delimiter": "<delimiter>",
    "provider": "<storage-provider>"
  }
}

{
  "ok": 1,
  "store": {
    "name": "<store-name>",
    "region": "<region-name>",
    "serviceURL": "<service-account-URL>",
    "containerName": "<storage-container-name>"
    "delimiter": "<delimiter>",
    "provider": "<storage-provider>"
  }
}

{
  "ok": 1,
  "store": {
    "name": "<store-name>",
    "region": "<region-name>",
    "bucket": "<storage-container-name>"
    "delimiter": "<delimiter>",
    "prefix": "<prefix>",
    "provider": "<storage-provider>"
  }
}

{
        "ok" : 1,
        "store" : {
                "name" : "<store-name>",
                "provider" : "<storage-provider>",
                "clusterName" : "<cluster-name>",
                "projectId" : "<project-id>",
                "readPreference" : {
                       "mode" : "<read-preference-mode>",
                       "tagSets" : [[{"name": "<name>", "value": "<value>"},...],...],
                       "maxStalenessSeconds" : <number-of-seconds>
                }
        }
}

{
        "ok" : 1,
        "store" : {
                "name" : "<store-name>",
                "provider" : "<storage-provider>",
                "allowInsecure" : true|false,
                "urls" : [
                        "<url>"
                ],
                "defaultFormat: "<file-extension>"
        }
}

{
  ok: 1,
  store: {
    name: '<store-name>',
    provider: 'dls:aws',
    region: '<online-archive-region>'
  }
}

예시

다음 예에서는 createStore 명령을 사용하여 myStore 라는 새 연합 데이터베이스 인스턴스 저장소를 만듭니다.

use sample
db.runCommand({ createStore: "myStore", provider: "s3", region: "us-east-1", bucket: "my-bucket", "additionalStorageClasses" : ["STANDARD_IA","INTELLIGENT_TIERING"] })

{
  "ok": 1,
  "store": {
    "name": "myStore",
    "region": "us-east-1",
    "bucket": "my-bucket",
    "additionalStorageClasses" : [
                        "STANDARD_IA",
                        "INTELLIGENT_TIERING"
                ],
    "delimiter": "/",
    "provider": "s3"
  }
}

use sample
db.runCommand({ createStore: "myStore", provider: "azure", region: "eastus2", serviceURL: "https://mystorage.blob.core.windows.net/", "containerName" : "my-data-container" })

{
  "ok": 1,
  "store": {
    "name": "myStore",
    "region": "eastus2",
    "serviceURL": "https://mystorage.blob.core.windows.net/",
    "containerName" : "my-data-container",
    "delimiter": "/",
    "provider": "azure"
  }
}

use sample
db.runCommand({ createStore: "myStore", provider: "azure", region: "us-central1", "bucket" : "my-data-container" })

{
  "ok": 1,
  "store": {
    "name": "myStore",
    "region": "us-central1",
    "bucket" : "my-data-container",
    "delimiter": "/",
    "provider": "gcp"
  }
}

use sample
db.runCommand({ createStore: "myStore", provider: "atlas", clusterName: "myTestCluster", projectId: "<project-id>", "readPreference": {"mode": "secondary", "tagSets": [[{"name": "provider", "value": "AWS" }, {"name": "region", "value": "US_EAST_1"}]], "maxStalenessSeconds": 120} })

{
        "ok" : 1,
        "store" : {
                "name" : "myStore",
                "provider" : "atlas",
                "clusterName" : "myTestCluster",
                "projectId" : "<project-id>",
                "readPreference" : {
                        "mode" : "secondary",
                        "tagSets": [[{"name": "provider", "value": "AWS" }, {"name": "region", "value": "US_EAST_1"}]],
                        "maxStalenessSeconds" : 120
                }
        }
}

use sample
db.runCommand({ createStore: "myStore", provider: "http", urls: ["https://atlas-data-lake.s3.amazonaws.com/json/sample_airbnb/listingsAndReviews","http://example.mongodb.com/sampleData"], allowInsecure: true, defaultFormat: ".json" })

{
        "ok" : 1,
        "store" : {
                "name" : "http-store",
                "provider" : "http",
                "urls" : [
                        "https://atlas-data-lake.s3.amazonaws.com/json/sample_airbnb/listingsAndReviews",
                        "http://example.mongodb.com/sampleData"
                ],
                "defaultFormat" : ".json"
                "allowInsecure" : true
        }
}

use sample
db.runCommand({ createStore: "myStore", provider: "dls:aws", region: "us-east-1" })

{
  ok: 1,
  store: {
    name: 'myStore',
    provider: 'dls:aws',
    region: 'us-east-1'
  }
}

오류 문제 해결

명령이 실패하면 다음 오류 중 하나를 반환합니다.

이유: createStore 에 지정된 이름을 가진 연합 데이터베이스 인스턴스 저장소가 이미 존재합니다.

{
  "ok": 0,
  "errmsg": "store <store-name> already exists",
  "code": 2,
  "codeName": "BadValue"
}

해결책: 연합 데이터베이스 인스턴스 저장소에 고유한 이름을 지정합니다.

이유: 지정된 provider 이(가) 인식되지 않습니다.

{
  "ok": 0,
  "errmsg": "unrecognized store provider <storage-provider>",
  "code": 2,
  "codeName": "BadValue"
}

해결책: 유효한 스토리지 제공자를 지정했는지 확인합니다.

이유: 하나 이상의 지정된 URL에 안전하지 않은 HTTP 체계가 포함되어 있습니다.

{
        "ok" : 0,
        "errmsg" : "store 'httpStore': the insecure HTTP scheme is not supported by default - please add a 'allowInsecure: true' flag to the store or datasource to query from such URLs, correlationID = 16332c6eddf7b32776fde638",
        "code" : 72,
        "codeName" : "InvalidOptions"
}

해결 방법: 보안 HTTPS체계를 사용하여 URL 을 지정합니다. 지정된 URL에 안전하지 않은 HTTP 체계가 있는 경우 allowInsecure 플래그를 true로 설정하다 . allowInsecure 플래그를 true로 설정하면 데이터가 중간자(man-in-the-middle) 공격에 취약해집니다.

돌아가기

구성 관리

스토어 목록