AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

연합 데이터베이스 인스턴스 데이터 저장 배포

연합 데이터베이스 인스턴스 데이터 저장 Atlas cloud 저장 소스에 연결하므로 데이터 전체에서 연합 쿼리를 실행 수 있습니다. 데이터 저장 AWS S3, Azure Blob Storage, Google Cloud Storage, HTTP 또는 HTTPS endpoints, 또는 Atlas cluster 에 배포 할 수 있습니다.

연합 데이터베이스 인스턴스 데이터 저장소를 배포하려면 드롭다운 메뉴에서 데이터 저장소를 선택합니다.

Amazon Web Services S3에 연합 데이터베이스 인스턴스 배포

이 페이지에서는 AWS S3의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스를 배포하는 방법을 설명합니다.

연합 데이터베이스 인스턴스 배포 하려면 프로젝트에 대한 Project Owner 액세스 있어야 합니다.

중요

Organization Owner 액세스 있는 사용자는 연합 데이터베이스 인스턴스 배포하기 전에 프로젝트에 Project Owner (으)로 추가되어야 합니다.

Amazon Web Services S3 버킷에 연합 데이터베이스 인스턴스를 배포하기 전에 다음 단계를 완료해야 합니다.

  1. MongoDB Atlas 계정이 아직 없는 경우 생성합니다.

  2. AWS CLI 구성 AWS 계정에 액세스할 수 있도록 합니다. 아니면 IAM 역할 을(를) 생성할 수 있는 권한으로 AWS 관리 콘솔에 액세스할 수 있어야 합니다.

Atlas CLI를 사용하여 새 Data Federation 데이터베이스를 생성하려면 다음 명령을 실행합니다.

atlas dataFederation create <name> [options]

명령 구문 및 매개변수에 Atlas CLI 학습 보려면 dataFederation create Atlas 에 대한 설명서를 참조하세요.

Amazon Web Services S3에 연합 데이터베이스 인스턴스 배포

이 페이지에서는 AWS S3의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스를 배포하는 방법을 설명합니다.

연합 데이터베이스 인스턴스 배포 하려면 프로젝트에 대한 Project Owner 액세스 있어야 합니다.

중요

Organization Owner 액세스 있는 사용자는 연합 데이터베이스 인스턴스 배포하기 전에 프로젝트에 Project Owner (으)로 추가되어야 합니다.

Amazon Web Services S3 버킷에 연합 데이터베이스 인스턴스를 배포하기 전에 다음 단계를 완료해야 합니다.

  1. MongoDB Atlas 계정이 아직 없는 경우 생성합니다.

  2. AWS CLI 구성 AWS 계정에 액세스할 수 있도록 합니다. 아니면 IAM 역할 을(를) 생성할 수 있는 권한으로 AWS 관리 콘솔에 액세스할 수 있어야 합니다.

1
2
3
  1. Create New Federation Database 드롭다운을 클릭합니다.

  2. 메뉴에서 수동 설정 선택합니다.

4
  1. cloud 제공자 로 AWS를 선택하세요.

  2. 연합 데이터베이스 인스턴스 이름을 입력합니다.

  3. 계속을 클릭합니다.

참고로: 연합 데이터베이스 인스턴스 이름은 기본적으로 FederatedDatabaseInstance[n]입니다. 연합 데이터베이스 인스턴스 생성되면 이름을 바꿀 수 없습니다.

5
  • 시각적 인터페이스의 경우 Visual를 클릭합니다.

  • JSON 파일에서 직접 편집하려면 JSON Editor을(를) 클릭합니다.

6
  1. Data Sources 섹션에서 연합 데이터베이스 인스턴스의 데이터 세트를 선택합니다.

    Add Data Sources 을 클릭하여 데이터 저장소를 선택합니다.

  2. 데이터 저장소를 지정합니다.

    Amazon S3를 선택하여 AWS S3 버킷의 데이터에 대한 연합 데이터베이스 인스턴스 구성합니다.

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

  3. Atlas 에 대한 AWS IAM 역할 선택합니다.

    역할 선택 드롭다운 목록에서 Atlas가 승인한 기존 Amazon Web Services IAM 역할을 선택하거나 Authorize an AWS IAM Role을 선택하여 새 역할을 승인할 수 있습니다.

    Atlas에 사용하도록 인증된 기존 역할을 선택했다면 다음 단계로 넘어가서 사용자의 AWS S3 버킷의 목록을 볼 수 있습니다.

    기존 역할을 사용할 수 있도록 Atlas를 인증하거나 새 역할을 생성하려는 경우, 아래 단계를 완료한 후에 그 다음 단계로 넘어가세요.

    1. Authorize an AWS IAM Role 을 선택하여 새 역할을 인증하거나 드롭다운에서 기존 역할을 선택하고 Next 을 클릭합니다.

    2. Add Atlas to the trust relationships of your AWS IAM role 섹션에서 Amazon Web Services ARN 과 고유한 외부 ID를 사용하여 기존 또는 새 Amazon Web Services IAM 역할의 신뢰 관계에 Atlas를 추가합니다.

      Atlas UI에서 다음 중 하나를 클릭하고 확장합니다.

      • Create New Role with the AWS CLI은(는) ARN 과 고유한 외부 ID를 사용하여 새 Amazon Web Services IAM 역할의 신뢰 관계에 Atlas를 추가하는 방법을 보여줍니다. 새 역할을 생성하려면 Atlas UI에 명시되어 있는 단계대로 하세요. 자세한 내용 은 AWS CLI를 사용하여 새 역할 생성을 참조하세요.

        새 역할을 인증할 때 Configure a New Data Lake 워크플로를 종료하는 경우:

        • Atlas 역할 의 유효성을 검사하기 전에 연합 데이터베이스 인스턴스 생성하지 않습니다. Atlas Integrations 페이지로 이동하여 새 역할 인증할 수 있습니다. AWS IAM 역할 ARN이 있으면 워크플로를 재개할 수 있습니다.

        • Atlas는 역할의 유효성을 검사한 후에 연합 데이터베이스 인스턴스를 생성하지 않습니다. 다만 해당 역할은 역할 선택 드롭다운에 포함되며, 연합 데이터베이스 인스턴스 생성 시 사용할 수 있습니다. 해당 역할을 다시 인증할 필요는 없습니다.

      • Add Trust Relationships to an Existing Role 은(는) ARN 과 고유한 외부 ID를 사용하여 기존 AWS IAM 역할의 신뢰 관계에 Atlas를 추가하는 방법을 보여줍니다. 기존 역할의 신뢰 관계에 Atlas를 추가하려면 Atlas UI에 명시되어 있는 단계대로 하세요. 자세한 내용 은 기존 역할에 신뢰 관계 추가 를 참조하세요.

      중요: 나중에 사용자 지정 AWS 역할 ARN을 수정하는 경우, 해당 역할 에 대한 액세스 정책에 연합 데이터베이스 인스턴스 의 S3 리소스에 대한 적절한 액세스 이 포함되어 있는지 확인하세요.

      자세한 내용은 다음을 참조하세요.
    3. Next를 클릭합니다.

  4. S3 버킷 정보를 입력합니다.

    1. S3 버킷의 이름을 입력합니다.

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

    2. 버킷이 Read-only 인지 또는 둘 다 Read and write 인지 지정합니다.

      Atlas Read-only 버킷만 쿼리 할 수 있습니다. 쿼리 결과를 쿼리 하고 S3 버킷에 저장하려면 Read and write를 선택합니다. 쿼리 결과를 S3 버킷에 저장하려면, AWS 리소스에 대한 Atlas 액세스 부여하는 역할 정책에 s3:ListBucket, s3:GetObject, s3:GetObjectVersion 외에 s3:PutObject 및 s3:DeleteObject 권한이 포함되어야 합니다. 및 읽기 액세스 권한을 부여하는 s3:GetBucketLocation 권한이 있습니다. AWS IAM 역할 에 액세스 정책을 할당하는 방법에 대해 자세히 학습 아래 4단계를 참조하세요.

    3. S3 버킷의 리전 을 선택합니다.

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

      중요: Atlas Data Federation 지정된 S3 버킷의 리전 조회 할 수 없는 경우 연합 데이터베이스 인스턴스 만들 수 없습니다.

    4. 선택 사항. Data Federation S3 버킷의 파일을 검색할 때 사용해야 하는 접두사를 지정합니다. 생략하면 Data Federation S3 버킷의 루트에서 모든 파일을 재귀적으로 검색 합니다.

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

    5. Next를 클릭합니다.

  5. AWS IAM 역할 에 액세스 정책을 할당합니다.

    1. Atlas user 인터페이스의 단계에 따라 AWS IAM 역할 에 액세스 정책을 할당합니다.

      읽기 전용 또는 읽기 및 쓰기 액세스에 대한 역할 정책은 다음과 유사해야 합니다.

      {
      "Version": "2012-10-17",
      "Statement": [
      {
      "Effect": "Allow",
      "Action": [
      "s3:ListBucket",
      "s3:GetObject",
      "s3:GetObjectVersion",
      "s3:GetBucketLocation"
      ],
      "Resource": [
      <role arn>
      ]
      }
      ]
      }
    2. Next를 클릭합니다.

  6. S3 버킷에서 파일의 경로 구조를 정의하고 Next를 클릭합니다.

    예를 들면 다음과 같습니다.

    s3://<bucket-name>/<path>/<to>/<files>/<filename>.<file-extension>

    S3 버킷의 데이터에 경로를 추가하려면 Add Data Source를 클릭하고 경로를 입력합니다. 경로에 대해 자세히 학습 데이터 저장소에 대한 경로 구문 정의를 참조하세요.

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

  7. 가상 데이터베이스, 컬렉션 및 뷰를 생성하고 데이터베이스, 컬렉션 및 뷰를 데이터 저장소에 매핑합니다.

    1. (선택 사항) 다음을 클릭합니다. 의 경우:

      • 데이터베이스를 클릭하여 데이터베이스 이름을 편집합니다. 기본값은 VirtualDatabase[n] 입니다.

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

      • 컬렉션을 클릭하여 컬렉션 이름을 편집합니다. 기본값은 VirtualCollection[n] 입니다.

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

      • 보기 이름을 편집하려면 보기를 클릭합니다.

      다음을 클릭할 수 있습니다.

      • Add Database 데이터베이스 및 컬렉션을 추가합니다.

      • 데이터베이스에 컬렉션을 추가하기 위해 데이터베이스와 연결됩니다.

      • 을(를) 클릭하여 컬렉션 에 대한 뷰 를 추가 컬렉션. 뷰를 만들려면 다음을 지정해야 합니다.

        • 뷰의 이름을 지정합니다.

        • 뷰에 적용할 파이프라인 입니다.

          뷰 정의 파이프라인은 $out 또는 $merge 단계를 포함할 수 없습니다. 뷰 정의에 $lookup 또는 $facet 와 같은 중첩된 파이프라인 단계가 포함된 경우 이 제한은 해당 중첩된 파이프라인에도 적용됩니다.

        뷰에 학습 보려면 다음을 참조하세요.

      • 데이터베이스, 컬렉션 또는 뷰와 연결된 항목을 제거합니다.

    2. Data Sources 섹션의 드롭다운에서 AWS S3 를 선택합니다.

    3. 데이터 저장소를 드래그 앤 드롭하여 컬렉션과 매핑합니다.

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

7
8

Microsoft Azure 에서 연합 데이터베이스 인스턴스 배포

이 페이지에서는 Azure Blob Storage 컨테이너의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스를 배포하는 방법을 설명합니다.

시작하기 전에 다음 사전 요구 사항을 완료하세요.

Atlas CLI를 사용하여 새 Data Federation 데이터베이스를 생성하려면 다음 명령을 실행합니다.

atlas dataFederation create <name> [options]

명령 구문 및 매개변수에 Atlas CLI 학습 보려면 dataFederation create Atlas 에 대한 설명서를 참조하세요.

Microsoft Azure 에서 연합 데이터베이스 인스턴스 배포

이 페이지에서는 Azure Blob Storage 컨테이너의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스를 배포하는 방법을 설명합니다.

시작하기 전에 다음 사전 요구 사항을 완료하세요.

1
2
3
  1. Create New Federated Database 드롭다운을 클릭합니다.

  2. Manual Setup0}을 선택합니다.

4

AWS, Azure 또는 Google Cloud를 선택할 수 있습니다. 연합 데이터베이스 인스턴스 생성되면 Atlas Data Federation 쿼리를 처리하는 cloud 제공자 변경할 수 없습니다.

Azure Blob Storage 컨테이너 의 데이터에 대한 연합 데이터베이스 인스턴스 구성하는 경우 데이터를 호스팅하는 cloud 제공자 와 다른 cloud 제공자 선택할 수 없습니다. 즉,Azure 선택해야 합니다.

5

FederatedDatabaseInstance[n](으)로 기본 설정됩니다. 연합 데이터베이스 인스턴스가 생성되고 나면 해당 인스턴스의 이름을 변경할 수 없습니다.

6
  • 안내를 따라 진행하고자 할 때는 Visual Editor를 클릭합니다.

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

7
  1. Data Sources 섹션에서 연합 데이터베이스 인스턴스의 데이터 세트를 선택합니다.

    Add Data Sources 을 클릭하여 데이터 저장소를 선택합니다.

  2. 데이터 저장소를 지정합니다.

    Azure Blob Storage 컨테이너의 데이터에 대한 연합 데이터베이스 인스턴스 를 구성하려면 Azure 를 선택합니다.

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

  3. Atlas 에 대한 Azure 서비스 주체를 선택합니다.

    서비스 주체 드롭다운에서 Atlas 가 인증하는 기존 Azure 서비스 주체를 선택하거나 Authorize an Azure Service Principal을 선택하여 새 서비스 주체를 인증할 수 있습니다.

    Atlas 에 권한이 부여된 기존 서비스 주체를 선택한 경우 다음 단계로 진행하세요.

    기존 서비스 주체에 대해 Atlas 를 승인하거나 새 서비스 주체를 생성하는 경우 다음 단계로 진행하기 전에 다음 단계를 완료하세요.

    1. 새 서비스 주체 또는 기존 서비스 주체를 승인하려면 Authorize an Azure Service Principal 을 선택하고 Continue 을 클릭합니다.

      Add Atlas to your Azure Service Principal 섹션에서 Azure 서비스 주체 AppId를 사용하여 기존 또는 새 Azure 서비스 주체를 통해 Atlas 액세스 부여합니다.

    2. Atlas UI의 PowerShell 또는 AzureCLI 탭에 설명된 단계에 따라 새 서비스 주체를 만들거나 기존 서비스 주체를 수정합니다.

    3. Atlas UI의 단계를 완료한 후 각 필드에 테넌트 ID 및 서비스 주체 ID를 입력합니다.

    4. 다음 단계로 진행하려면 Validate and Finish 을 클릭합니다.

  4. Azure Blob Storage에 액세스 를 구성합니다.

    Configure Azure Blob Storage 페이지에서 Azure Storage 계정 자격 증명 위임 및 스토리지 컨테이너 액세스 구성해야 합니다. 이를 수행하려면 다음을 수행합니다.

    1. Storage Account Credential Delegation 필드 에 스토리지 계정 리소스 ID 를 입력합니다.

      자세한 학습 은 저장 계정의 리소스 ID 가져오기를 참조하세요.

    2. Azure PowerShell의 Storage Account Credential Delegation 단계에서 명령을 복사하고 실행 자격 증명 위임을 설정하다 합니다.

    3. 스토리지 컨테이너가 Read only 또는 Read and write 작업을 허용할지 여부를 지정합니다.

      Atlas는 Read-only 컨테이너만 쿼리할 수 있습니다. 쿼리 결과를 쿼리하고 Azure Blob Storage 컨테이너에 저장하려면 Read and write 을(를) 선택합니다.

      Atlas Data Federation (는) $out을 사용한 Azure Blob Storage 컨테이너 에 대한 쓰기를 지원 하지 않습니다.

    4. 스토리지 컨테이너 이름을 입력합니다.

    5. Azure PowerShell의 Storage Container Access 단계에 표시된 명령을 복사하고 실행 블롭 컨테이너 액세스 설정하다 합니다.

    6. Continue를 클릭합니다.

  5. Azure Blob Storage 컨테이너 에서 파일의 경로 구조를 정의하고 Next 을(를) 클릭합니다.

    1. Azure Blob Storage 컨테이너 의 저장 경로를 입력합니다.

      예를 들면 다음과 같습니다.

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

      Azure Blob Storage 컨테이너 의 데이터에 경로를 추가하려면 Add Data Source를 클릭하고 경로를 입력합니다. 경로에 대해 자세히 학습 데이터 저장소에 대한 경로 구문 정의를 참조하세요.

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

    2. 선택 사항. Data Federation 이 Azure Blob Storage 컨테이너 의 파일을 검색할 때 사용해야 하는 파티션 필드와 필드 값 유형을 지정합니다.

      생략하면 Data Federation 은 Azure Blob Storage 컨테이너 의 루트에서 모든 파일에 대해 재귀 검색 을 수행합니다. 특정 필드 값 유형을 선택하지 않으면 Data Federation 은 모든 쿼리에서 해당 경로에 있는 값을 추가합니다.

      stores.[n].prefix 및 databases.[n].collections.[n].dataSources.[n].path JSON 구성 설정에 해당합니다.

  6. 가상 데이터베이스, 컬렉션 및 뷰를 생성하고 데이터베이스, 컬렉션 및 뷰를 데이터 저장소에 매핑합니다.

    1. (선택 사항) 다음을 클릭합니다. 의 경우:

      • 데이터베이스를 클릭하여 데이터베이스 이름을 편집합니다. 기본값은 VirtualDatabase[n] 입니다.

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

      • 컬렉션을 클릭하여 컬렉션 이름을 편집합니다. 기본값은 VirtualCollection[n] 입니다.

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

      • 보기 이름을 편집하려면 보기를 클릭합니다.

      다음을 클릭할 수 있습니다.

      • Add Database 데이터베이스 및 컬렉션을 추가합니다.

      • 데이터베이스에 컬렉션을 추가하기 위해 데이터베이스와 연결됩니다.

      • 을(를) 클릭하여 컬렉션 에 대한 뷰 를 추가 컬렉션. 뷰를 만들려면 다음을 지정해야 합니다.

        • 뷰의 이름을 지정합니다.

        • 뷰에 적용할 파이프라인 입니다.

          뷰 정의 파이프라인은 $out 또는 $merge 단계를 포함할 수 없습니다. 뷰 정의에 $lookup 또는 $facet 와 같은 중첩된 파이프라인 단계가 포함된 경우 이 제한은 해당 중첩된 파이프라인에도 적용됩니다.

        뷰에 학습 보려면 다음을 참조하세요.

      • 데이터베이스, 컬렉션 또는 뷰와 연결된 항목을 제거합니다.

    2. Data Sources 섹션의 드롭다운에서 Azure Blob Storage 를 선택합니다.

    3. 데이터 저장소를 드래그 앤 드롭하여 컬렉션과 매핑합니다.

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

8

연합 쿼리에 대한 다른 데이터 저장소를 추가하려면 다음을 참조하세요.

참고

다양한 cloud 제공자 간에 연합 쿼리를 실행 위한 AWS 데이터 저장 생성할 수 없습니다.

9

Google Cloud Platform 에 연합 데이터베이스 인스턴스 배포

이 페이지에서는 Google Google Cloud Platform Cloud Platform Storage 버킷의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스 를 배포 하는 방법을 설명합니다.

연합 데이터베이스 인스턴스 배포 하려면 프로젝트에 대한 Project Owner 액세스 있어야 합니다.

중요

Organization Owner 액세스 있는 사용자는 연합 데이터베이스 인스턴스 배포하기 전에 프로젝트에 Project Owner (으)로 추가되어야 합니다.

시작하기 전에 다음을 수행해야 합니다.

Atlas CLI를 사용하여 새 Data Federation 데이터베이스를 생성하려면 다음 명령을 실행합니다.

atlas dataFederation create <name> [options]

명령 구문 및 매개변수에 Atlas CLI 학습 보려면 dataFederation create Atlas 에 대한 설명서를 참조하세요.

Google Cloud Platform 에 연합 데이터베이스 인스턴스 배포

이 페이지에서는 Google Google Cloud Platform Cloud Platform Storage 버킷의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스 를 배포 하는 방법을 설명합니다.

연합 데이터베이스 인스턴스 배포 하려면 프로젝트에 대한 Project Owner 액세스 있어야 합니다.

중요

Organization Owner 액세스 있는 사용자는 연합 데이터베이스 인스턴스 배포하기 전에 프로젝트에 Project Owner (으)로 추가되어야 합니다.

시작하기 전에 다음을 수행해야 합니다.

1
2
3
  1. Create New Federated Database 드롭다운을 클릭합니다.

  2. Manual Setup0}을 선택합니다.

4

AWS, Azure 또는 Google Cloud를 선택할 수 있습니다. 연합 데이터베이스 인스턴스 생성되면 Atlas Data Federation 쿼리를 처리하는 cloud 제공자 변경할 수 없습니다.

연합 데이터베이스 인스턴스 가 매핑되는 데이터 저장소와 동일한 cloud 제공자 에 연합 데이터베이스 인스턴스 를 구성해야 합니다.

5

FederatedDatabaseInstance[n](으)로 기본 설정됩니다. 연합 데이터베이스 인스턴스가 생성되고 나면 해당 인스턴스의 이름을 변경할 수 없습니다.

6
  • 안내를 따라 진행하고자 할 때는 Visual Editor를 클릭합니다.

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

7
  1. Data Sources 섹션에서 연합 데이터베이스 인스턴스의 데이터 세트를 선택합니다.

    Add Data Sources 을 클릭하여 데이터 저장소를 선택합니다.

  2. 데이터 저장소를 지정합니다.

    Google Cloud Storage Google Cloud Google Cloud Platform Platform Storage 버킷의 데이터에 대한 연합 데이터베이스 인스턴스 를 구성하려면 를 선택합니다.

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

  3. Atlas Google Cloud Platform 용 Google Cloud Platform 서비스 계정을 선택합니다.Atlas

    역할 선택 드롭다운 Google Cloud Platform Atlas Create a Google Service Account목록에서 Atlas 에 인증된 기존 Google Cloud Platform 서비스 계정을 선택하거나 를 선택할 수 있습니다.

    Atlas 가 인증되는 기존 계정을 선택한 경우 Atlas 를 클릭하고 Next 다음 단계로 Google Cloud Platform 진행하여 Google Cloud Platform Storage 버킷을 나열합니다.

    새 서비스 계정을 생성하는 경우 Create a Google Service Account 을(를) 선택하고 Next을(를) 클릭합니다.

  4. Configure Google Cloud Storage 모달에서 제공된 지침에 따라 Google Cloud Platform CLI NextGoogle Cloud Platform CLI 를 구성한 다음 를 클릭합니다.

  5. Google Cloud Platform 스토리지를 Google Cloud Platform 구성합니다.

    1. Google Google Cloud Platform Cloud Platform 스토리지 버킷의 이름을 입력합니다.

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

    2. 버킷이 Read-only 인지 또는 둘 다 Read and write 인지 지정합니다.

      Atlas 는 버킷만Atlas 쿼리 할 수 있습니다. 쿼리 결과를 쿼리 하여 Google Read-only Google Cloud Platform Cloud Platform Storage 버킷에 저장하려면 Read and write 을(를) 선택합니다.

    3. Google Google Cloud Platform Cloud Platform 스토리지 버킷의 리전 을 선택합니다.

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

      참고

      Atlas Data Federation 이 지정된 GCP Storage 버킷의 리전 을 조회 Atlas Data Federation 할 수 없는 경우 연합 데이터베이스 인스턴스 만들 수 없습니다.GCP

    4. Google Cloud Platform 프로젝트 에 액세스 을 부여합니다.Google Cloud Platform

      1. Google Cloud Platform Storage 버킷을 Google Cloud Platform 호스팅하는 프로젝트 의 Google Cloud Platform 콘솔에서 로 Google Cloud Platform IAM and Admin 이동한 IAM 다음 로 이동합니다.

      2. Grant Access 을(를) 클릭합니다. 표시되는 모달의 필드 New principals Google Cloud Platform 에 연합 데이터베이스 인스턴스 와 연결된 Google Cloud Platform 서비스 계정을 입력합니다.

      3. 버킷에 읽기 전용 액세스 을 부여하려면 storage.viewer 역할 적용 합니다. 버킷에 대한 읽기-쓰기 액세스 을 부여하려면 storage.editor 역할 추가로 적용 합니다.

    5. 선택 사항. Data Federation 이 Google Cloud Platform Storage 버킷에서 파일을 검색할 때 사용해야 하는 접두사를 지정합니다.Data Federation Google Cloud Platform 생략하면 Data Federation 은 Google Cloud Platform Storage 버킷의 루트에서 Data Federation 모든 파일을 재귀적으로 검색 합니다.Google Cloud Platform

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

    6. 클릭 Validate and finish.

  6. Google Cloud Platform Storage 버킷에서 파일의 경로 구조를 정의하고 Google Cloud Platform Next 를 클릭합니다.

    예를 들면 다음과 같습니다.

    https://storage.googleapis.com/<path>/<to>/<files>/<filename>.<file-extension>

    Google Cloud Platform 저장 버킷의 데이터에 경로를 추가하려면 Add Data Source 를 클릭하고 경로를 입력합니다. 경로에 대해 자세히 학습하려면, 데이터 저장소의 경로 구문 정의를 참조하세요.

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

  7. 가상 데이터베이스, 컬렉션 및 뷰를 생성하고 데이터베이스, 컬렉션 및 뷰를 데이터 저장소에 매핑합니다.

    1. (선택 사항) 다음을 클릭합니다. 의 경우:

      • 데이터베이스를 클릭하여 데이터베이스 이름을 편집합니다. 기본값은 VirtualDatabase[n] 입니다.

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

      • 컬렉션을 클릭하여 컬렉션 이름을 편집합니다. 기본값은 VirtualCollection[n] 입니다.

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

      • 보기 이름을 편집하려면 보기를 클릭합니다.

      다음을 클릭할 수 있습니다.

      • Add Database 데이터베이스 및 컬렉션을 추가합니다.

      • 데이터베이스에 컬렉션을 추가하기 위해 데이터베이스와 연결됩니다.

      • 을(를) 클릭하여 컬렉션 에 대한 뷰 를 추가 컬렉션. 뷰를 만들려면 다음을 지정해야 합니다.

        • 뷰의 이름을 지정합니다.

        • 뷰에 적용할 파이프라인 입니다.

          뷰 정의 파이프라인은 $out 또는 $merge 단계를 포함할 수 없습니다. 뷰 정의에 $lookup 또는 $facet 와 같은 중첩된 파이프라인 단계가 포함된 경우 이 제한은 해당 중첩된 파이프라인에도 적용됩니다.

        뷰에 학습 보려면 다음을 참조하세요.

      • 데이터베이스, 컬렉션 또는 뷰와 연결된 항목을 제거합니다.

    2. Data Sources 섹션의 드롭다운에서 Google Cloud Storage 를 선택합니다.

    3. 데이터 저장소를 드래그 앤 드롭하여 컬렉션과 매핑합니다.

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

8

연합 쿼리에 대한 다른 데이터 저장소를 추가하려면 다음을 참조하세요.

참고

클라우드 공급자 간에 페더레이션 쿼리를 실행 하기 위해 Azure Blob Storage 데이터 저장소를 연결할 수 없습니다.

9

HTTP 데이터 저장소에 연합 데이터베이스 인스턴스 배포

이 페이지에서는 HTTP 데이터 저장소의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스를 배포하는 방법에 대해 설명합니다.

연합 데이터베이스 인스턴스 배포 하려면 프로젝트에 대한 Project Owner 액세스 있어야 합니다.

중요

Organization Owner 액세스 있는 사용자는 연합 데이터베이스 인스턴스 배포하기 전에 프로젝트에 Project Owner (으)로 추가되어야 합니다.

시작하기 전에 다음을 수행해야 합니다.

중요

  • HTTP 데이터 저장소에 HTTPS를 통해 액세스할 수 없는 경우, JSON Editor를 사용하여 데이터 저장소를 구성해야 합니다. JSON 구성에서 stores.[n].allowInsecure 설정을 true로 설정해야 합니다.

  • Atlas Data Federation은 인증이 필요한 HTTP 데이터 저장소 URL을 지원하지 않습니다.

Atlas CLI를 사용하여 새 Data Federation 데이터베이스를 생성하려면 다음 명령을 실행합니다.

atlas dataFederation create <name> [options]

명령 구문 및 매개변수에 Atlas CLI 학습 보려면 dataFederation create Atlas 에 대한 설명서를 참조하세요.

HTTP 데이터 저장소에 연합 데이터베이스 인스턴스 배포

이 페이지에서는 HTTP 데이터 저장소의 데이터에 액세스하기 위해 연합 데이터베이스 인스턴스를 배포하는 방법에 대해 설명합니다.

연합 데이터베이스 인스턴스 배포 하려면 프로젝트에 대한 Project Owner 액세스 있어야 합니다.

중요

Organization Owner 액세스 있는 사용자는 연합 데이터베이스 인스턴스 배포하기 전에 프로젝트에 Project Owner (으)로 추가되어야 합니다.

시작하기 전에 다음을 수행해야 합니다.

중요

  • HTTP 데이터 저장소에 HTTPS를 통해 액세스할 수 없는 경우, JSON Editor를 사용하여 데이터 저장소를 구성해야 합니다. JSON 구성에서 stores.[n].allowInsecure 설정을 true로 설정해야 합니다.

  • Atlas Data Federation은 인증이 필요한 HTTP 데이터 저장소 URL을 지원하지 않습니다.

1
2
3
  1. Create New Federated Database 드롭다운을 클릭합니다.

  2. Manual Setup0}을 선택합니다.

4

AWS, Azure 또는 Google Cloud를 선택할 수 있습니다. 연합 데이터베이스 인스턴스 생성되면 Atlas Data Federation 쿼리를 처리하는 cloud 제공자 변경할 수 없습니다.

5

FederatedDatabaseInstance[n](으)로 기본 설정됩니다. 연합 데이터베이스 인스턴스가 생성되고 나면 해당 인스턴스의 이름을 변경할 수 없습니다.

6
  • 안내를 따라 진행하고자 할 때는 Visual Editor를 클릭합니다.

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

7
  1. Data Sources 섹션에서 연합 데이터베이스 인스턴스의 데이터 세트를 선택합니다.

    Add Data Sources 을 클릭하여 데이터 저장소를 선택합니다.

  2. 데이터 저장소를 지정합니다.

    공개적으로 액세스할 수 있는 HTTP 및 HTTPS URL 의 데이터에 대한 연합데이터베이스 인스턴스 구성하려면 HTTP(S)를 선택합니다.

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

  3. HTTP 데이터 저장 의 이름을 HTTP(S) Store Name 필드 에 입력합니다.

    참고

    데이터 저장소의 이름은 연합 데이터베이스 인스턴스 내에서 고유해야 합니다.

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

  4. 데이터가 저장된 파일 의 공개적으로 액세스할 수 있는 URL 입력합니다.

    Atlas Data Federation JSON, BSON, CSV, TSV, Avro(gzip 또는 비압축), Parquet 및 ORC 파일 형식을 지원합니다.

    팁

    Use Sample URL를 클릭하여 샘플 HTTP 데이터 저장 추가합니다.

    추가하려는 각 추가 HTTP 데이터 저장 에 대해 Add Another URL을 클릭한 다음 HTTP 데이터 저장 URL을 입력합니다.

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

  5. 가상 데이터베이스 및 collection을 구성하려면 Next 을 클릭합니다.

  6. 가상 데이터베이스, 컬렉션 및 뷰를 생성하고 데이터베이스, 컬렉션 및 뷰를 데이터 저장소에 매핑합니다.

    1. (선택 사항) 다음을 클릭합니다. 의 경우:

      • 데이터베이스를 클릭하여 데이터베이스 이름을 편집합니다. 기본값은 VirtualDatabase[n] 입니다.

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

      • 컬렉션을 클릭하여 컬렉션 이름을 편집합니다. 기본값은 VirtualCollection[n] 입니다.

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

      • 보기 이름을 편집하려면 보기를 클릭합니다.

      다음을 클릭할 수 있습니다.

      • Add Database 데이터베이스 및 컬렉션을 추가합니다.

      • 데이터베이스에 컬렉션을 추가하기 위해 데이터베이스와 연결됩니다.

      • 을(를) 클릭하여 컬렉션 에 대한 뷰 를 추가 컬렉션. 뷰를 만들려면 다음을 지정해야 합니다.

        • 뷰의 이름을 지정합니다.

        • 뷰에 적용할 파이프라인 입니다.

          뷰 정의 파이프라인은 $out 또는 $merge 단계를 포함할 수 없습니다. 뷰 정의에 $lookup 또는 $facet 와 같은 중첩된 파이프라인 단계가 포함된 경우 이 제한은 해당 중첩된 파이프라인에도 적용됩니다.

        뷰에 학습 보려면 다음을 참조하세요.

      • 데이터베이스, 컬렉션 또는 뷰와 연결된 항목을 제거합니다.

    2. Data Sources 섹션의 드롭다운에서 HTTP 를 선택합니다.

    3. 데이터 저장소를 드래그 앤 드롭하여 컬렉션과 매핑합니다.

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

8

연합 쿼리에 대한 다른 데이터 저장소를 추가하려면 다음을 참조하세요.

9

Atlas 클러스터 데이터로 연합 데이터베이스 인스턴스 배포

이 페이지에서는 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 클러스터 데이터로 연합 데이터베이스 인스턴스 배포

이 페이지에서는 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 중 하나 이상에 데이터를 추가하세요.

1
2
3
  1. Create New Federated Database 드롭다운을 클릭합니다.

  2. Manual Setup0}을 선택합니다.

4

AWS, Azure 또는 Google Cloud를 선택할 수 있습니다. 연합 데이터베이스 인스턴스 생성되면 Atlas Data Federation 쿼리를 처리하는 cloud 제공자 변경할 수 없습니다.

Atlas cluster 의 데이터를 쿼리 하려면 클러스터 의 cloud 제공자 와 동일한 cloud 제공자 를 선택하는 것이 좋습니다.AWS S3 또는 Azure Blob Storage와 같은 객체 저장 의 데이터를 쿼리 하려면 연합 데이터베이스 인스턴스 에 대해 객체 저장 에 대한 cloud 와 동일한 cloud 선택해야 합니다.

5

FederatedDatabaseInstance[n](으)로 기본 설정됩니다. 연합 데이터베이스 인스턴스가 생성되고 나면 해당 인스턴스의 이름을 변경할 수 없습니다.

6
  • 안내를 따라 진행하고자 할 때는 Visual Editor를 클릭합니다.

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

7
  1. Data Sources 섹션에서 연합 데이터베이스 인스턴스의 데이터 세트를 선택합니다.

    Add Data Sources 을 클릭하여 데이터 저장소를 선택합니다.

  2. 데이터 소스를 지정합니다.

    1. Atlas Cluster 를 선택하여 Atlas cluster의 데이터에 대한 연합 데이터베이스 인스턴스를 구성합니다.

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

    2. Provide Namespaces in this project 섹션에서 데이터 저장소로 사용할 Atlas cluster를 선택합니다.

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

    3. 데이터베이스를 확장하고 연합 데이터베이스 인스턴스에 추가하려는 컬렉션을 선택합니다.

      데이터베이스 및 컬렉션을 필터하다 하려면 Search database or collection 필드 에 텍스트를 입력합니다. 대화 상자에는 검색 기준과 일치하는 이름을 가진 데이터베이스 및 컬렉션만 표시됩니다.

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

    4. 선택 사항. 섹션을 확장하여 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

      읽기 요청을 라우팅하려는 복제본 세트 멤버의 이름 및 값 쌍이 포함된 태그 또는 태그를 지정하다 사양 문서의 목록을 지정합니다. 학습 내용은 읽기 설정 태그 세트를 참조하세요.

      stores.[n].readPreference.tagSets에 해당합니다.

      Maxstaleness Seconds

      세컨더리에서 읽기에 대한 최대 복제 지연 또는 '비활성'을 지정합니다. 학습 내용은 읽기 설정 maxStalenessSeconds를 참조하세요.

      stores.[n].readPreference.maxStalenessSeconds에 해당합니다.

    5. Next를 클릭합니다.

  3. 가상 데이터베이스, 컬렉션 및 뷰를 생성하고 데이터베이스, 컬렉션 및 뷰를 데이터 저장소에 매핑합니다.

    1. (선택 사항) 다음을 클릭합니다. 의 경우:

      • 데이터베이스를 클릭하여 데이터베이스 이름을 편집합니다. 기본값은 VirtualDatabase[n] 입니다.

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

      • 컬렉션을 클릭하여 컬렉션 이름을 편집합니다. 기본값은 VirtualCollection[n] 입니다.

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

      • 보기 이름을 편집하려면 보기를 클릭합니다.

      다음을 클릭할 수 있습니다.

      • Add Database 데이터베이스 및 컬렉션을 추가합니다.

      • 데이터베이스에 컬렉션을 추가하기 위해 데이터베이스와 연결됩니다.

      • 을(를) 클릭하여 컬렉션 에 대한 뷰 를 추가 컬렉션. 뷰를 만들려면 다음을 지정해야 합니다.

        • 뷰의 이름을 지정합니다.

        • 뷰에 적용할 파이프라인 입니다.

          뷰 정의 파이프라인은 $out 또는 $merge 단계를 포함할 수 없습니다. 뷰 정의에 $lookup 또는 $facet 와 같은 중첩된 파이프라인 단계가 포함된 경우 이 제한은 해당 중첩된 파이프라인에도 적용됩니다.

        뷰에 학습 보려면 다음을 참조하세요.

      • 데이터베이스, 컬렉션 또는 뷰와 연결된 항목을 제거합니다.

    2. Data Sources 섹션의 드롭다운에서 Atlas Cluster 를 선택합니다.

    3. 데이터 저장소를 드래그 앤 드롭하여 컬렉션과 매핑합니다.

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

8

연합 쿼리에 대한 다른 데이터 저장소를 추가하려면 다음을 참조하세요.

9
이 페이지 평가하기