개요
Atlas Data Federation이 연합 데이터베이스 인스턴스에 대해 처리하는 데이터의 양을 제한하여 비용을 관리할 수 있습니다. 처리되는 데이터 의 양을 제한하려면 연합 데이터베이스 인스턴스당 및 프로젝트의 모든 연합 데이터베이스 인스턴스에 대해 쿼리 제한을 구성할 수 있습니다. 구성하는 쿼리 한도는 데이터 처리 비용에만 적용되며 데이터 검색 및 전송과 같은 다른 Atlas Data Federation 비용에는 적용되지 않습니다.
쿼리 당, 일별 , 주별 , 월별 로 프로젝트별, 연합 데이터베이스 인스턴스별로 한도를 구성할 수 있습니다. Atlas Data Federation은 각 유형의 각 제한을 구성된 다른 제한과 독립적으로 간주합니다. 프로젝트와 프로젝트의 연합 데이터베이스 인스턴스에 대해 동일한 유형의 제한을 구성하는 경우 Atlas Data Federation은 둘 중 더 제한적인 제한을 적용합니다. 제한 값은 1GiB(1024^3바이트)에서 1EiB 사이여야 합니다.
기본적으로 Atlas Data Federation은 모든 새 연합 데이터베이스 인스턴스에 대한 월별 처리 데이터 양에 100TB 제한을 설정합니다.
참고
Atlas Data Federation은 클라우드 객체 저장 당 프로젝트 제한을 시행합니다. 예를 들어,2 개의 연합 데이터베이스 인스턴스가 있다고 가정해 봅시다.하나는 Amazon Web Services 에 있고, 다른 하나는 Azure</uc5d0 있습니다. Atlas Data Federation 사용하면 프로젝트 의 총 200TB에 대해 연합 데이터베이스 인스턴스 당 최대 100TB를 스캔할 수 있습니다.
Atlas Data Federation이 데이터 한도에 도달하면 어떻게 되나요?
제한 유형이 쿼리별 인 경우, 처리된 데이터의 용량이 구성된 제한 용량에 도달하면 Atlas Data Federation이 제한에 도달한 쿼리에 대한 데이터 처리를 중지합니다. 다른 유형의 제한의 경우, Atlas Data Federation은 구성된 제한 유형에 따라 제한이 재설정될 때까지 새 쿼리를 실행하지 않습니다. 즉, Atlas Data Federation은 다음이 될 때까지 새 쿼리를 실행하지 않습니다.
하루 한도 유형의 경우 UTC 부터 다음 역일입니다.
00:0000:00UTC 에 월요일에 시작하는 다음 주( 주당 제한 유형의 경우).매월 1일(1일)에 시작하는 다음 달
00:00UTC 의 매월 한도 유형의 경우.
프로젝트와 프로젝트의 연합 데이터베이스 인스턴스 모두에 대해 동일한 유형의 제한을 구성하지만, 프로젝트와 프로젝트의 연합 데이터베이스 인스턴스에 대해 한도 금액이 다른 경우 다음이 적용됩니다.
프로젝트의 연합 데이터베이스 인스턴스 한도에 도달하기 전에 Atlas Data Federation이 프로젝트 한도 금액에 도달하는 경우, Atlas Data Federation은 프로젝트의 모든 연합 데이터베이스 인스턴스에 대해 실행 중인 모든 쿼리를 완료하도록 허용합니다.
Atlas Data Federation이 프로젝트의 한도에 도달하지 않았지만 프로젝트의 연합 데이터베이스 인스턴스에 설정된 한도에 도달하는 경우, Atlas Data Federation은 해당 연합 데이터베이스 인스턴스에 대해 실행 중인 모든 쿼리가 완료되도록 허용하지만 실행되지는 않습니다. 해당 연합 데이터베이스 인스턴스에 대한 모든 새 쿼리. Atlas Data Federation은 프로젝트에 설정된 한도에 도달할 때까지 프로젝트의 다른 연합 데이터베이스 인스턴스에 대해 쿼리를 계속 실행합니다. Atlas Data Federation은 프로젝트 한도에 도달하면 프로젝트의 모든 연합 데이터베이스 인스턴스에 대해 실행 중인 모든 쿼리를 완료하도록 허용하지만, 프로젝트의 연합 데이터베이스 인스턴스에 대해서는 새 쿼리를 실행하지 않습니다.
Atlas Data Federation은 데이터 처리 한도에 도달하면 Atlas UI에 경고를 표시합니다. 또한 실행 중인 쿼리가 완료되도록 허용하는 대신 Atlas Data Federation이 제한에 도달하면 제한을 초과하는 쿼리를 최대한 빨리 종료하도록 Atlas Data Federation을 구성할 수 있습니다.
쿼리 종료를 활성화하면 어떻게 되나요?
제한을 초과하는 쿼리를 종료하도록 Atlas Data Federation 구성한 경우, Atlas Data Federation Atlas Data Federation 해당 제한에 도달하면 쿼리를 종료하려고 시도합니다. Atlas Data Federation 쿼리 종료하려고 시도하는 동안 Atlas Data Federation 제한을 약간 초과할 수 있습니다. Atlas Data Federation 어떤 결과도 반환하지 않고 ResourceExhausted 오류 코드(402)가 포함된 오류만 반환합니다. 그러나 한도에 도달하기 전에 Atlas Data Federation 처리한 데이터의 양에 대해 데이터 처리 요금이 표시됩니다.
프로젝트 와 프로젝트 의 연합 데이터베이스 인스턴스 모두에 대해 동일한 유형의 제한을 구성하지만 제한 금액과 쿼리 종료 설정이 다른 경우, Atlas Data Federation Atlas Data Federation 처리하는 데이터 양이 제한에 도달할 때만 쿼리 를 종료합니다. 쿼리 종료와 관련된 금액입니다.
예시
프로젝트가 종료가 활성화된 상태에서 주당 100GB로 제한되고 연합 데이터베이스 인스턴스가 종료가 허용된 상태에서 주당 60GB로 제한된다고 가정해 보겠습니다.
연합 데이터베이스 인스턴스에 대한 하나 이상의 쿼리가 60GB 제한에 도달하면 Atlas Data Federation은 연합 데이터베이스 인스턴스에 대해 실행 중인 모든 쿼리를 종료하고 새 쿼리를 실행하지 않습니다. Atlas Data Federation은 프로젝트 제한인 100GB에 도달할 때까지 프로젝트의 다른 연합 데이터베이스 인스턴스에 대해 실행 중인 모든 쿼리와 새 쿼리를 계속 실행합니다.
하나 이상의 쿼리가 프로젝트의 100GB 제한에 도달하면 Atlas Data Federation은 새 쿼리를 실행하지 않고 프로젝트의 모든 연합 데이터베이스 인스턴스에 대한 모든 쿼리를 종료합니다.
필요한 액세스 권한
To add, edit, or delete query limits, you must have Project Owner access to the project. Users with Organization Owner access must add themselves as a Project Owner to the project before adding, editing, or deleting query limits.
To view limits on queries, you must have Project Read Only access to the project or a role with more access.
절차
쿼리 제한 추가
Atlas CLI, Atlas UI 및 API 에서 쿼리에 대해 처리되는 데이터의 양에 대한 제한을 구성할 수 있습니다.
Atlas CLI를 사용하여 새 Data Federation 쿼리 제한을 만들려면 다음 명령을 실행합니다.
atlas dataFederation queryLimits create <name> [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas dataFederation queryLimits create.
연합 데이터베이스 인스턴스 당 또는 프로젝트 의 모든 연합 데이터베이스 인스턴스에 대한 제한을 구성하려면 Manage Query Limits를 클릭합니다.
프로젝트 및 연합 데이터베이스 인스턴스 별로 제한을 구성할 수 있습니다. 프로젝트 수준 쿼리 제한은 프로젝트 의 모든 연합 데이터베이스 인스턴스에 적용 되며, 처리된 데이터 양이 제한에 도달할 때 연합 데이터베이스 인스턴스 에 대한 새 쿼리를 방지합니다. 연합 데이터베이스 인스턴스에 대한 쿼리 제한은 해당 연합 데이터베이스 인스턴스 에만 적용 되며, 처리된 데이터베이스 의 양이 제한에 도달하면 Atlas Data Federation 은 해당 연합 데이터베이스 인스턴스 에 대해 새 쿼리 인스턴스 실행하지 않습니다. 선택적으로 Atlas Data Federation 이 구성된 제한에 도달하면 쿼리가 종료 활성화 설정할 수도 있습니다.
제한을 구성하려면 Add Query Limit 을 클릭합니다.
Add Query Limit 창 에서 다음 필드를 구성할 수 있습니다.
필드 이름 | 설명 |
|---|---|
Limit For | 제한이 프로젝트 또는 연합 데이터베이스 인스턴스 에 대한 것인지 여부를 지정합니다. 드롭다운을 클릭하고 제한을 적용 프로젝트 또는 연합 데이터베이스 인스턴스 를 선택합니다. 제한을 추가한 후에는 이 설정을 수정할 수 없습니다. |
Limit Type | 제한 기간을 지정합니다. 드롭다운을 클릭하여 다음 중 하나를 선택합니다.
제한을 추가한 후에는 이 설정을 수정할 수 없습니다. |
Limit Amount | 제한할 |
Terminate Queries | 쿼리 종료를 활성화 하려면 토글합니다. 기본값 으로 Atlas Data Federation 은 이 제한 유형의 제한에 도달하면 쿼리 를 종료하므로 쿼리 별 제한 유형에 대한 쿼리 종료를 활성화 할 수 없습니다. |
Add Query Limit 변경 사항을 적용하려면 을 클릭합니다.
Per query 유형의 제한의 경우 변경 사항이 즉시 적용되며 Atlas Data Federation 은 모든 새 쿼리에 대해서만 제한을 적용합니다. 다른 유형의 한도에는 다음 적용.
Per day - 변경 사항은 UTC 시간으로 현재 주 월요일이 시작될 때 적용됩니다.
Per week - 변경 사항은 UTC 시간으로 현재 주 월요일이 시작될 때 적용됩니다.
Per month - 변경 사항은 프로젝트 에 대한 월별 청구 기간이 시작되는 첫 번째 날(UTC 시간 기준)에 적용됩니다.
API 에서 쿼리 제한을 구성하려면 limits 엔드포인트에 POST 요청을 보냅니다.
프로젝트 의 모든 연합 데이터베이스 인스턴스에 적용되는 제한을 구성하려면 프로젝트 의 고유 ID 와 설정하다 제한의 이름을 지정해야 합니다. 프로젝트 의 모든 연합 데이터베이스 인스턴스에 대한 제한을 설정하는 구문 및 옵션에 학습 보려면 API 를 참조하세요.
To configure a limit for one federated database instance in a project, specify the unique ID of the project and the name of the federated database instance in the project. To learn more about the syntax and options for setting limits for one federated database instance in a project, see API.
쿼리 제한 보기
Atlas CLI, Atlas UI 및 API 에서 쿼리에 대한 프로젝트 및 연합 데이터베이스 인스턴스 제한을 볼 수 있습니다. Atlas Data Federation이 인스턴스당 하루에 처리한 데이터의 양도 볼 수 있습니다.
Atlas CLI를 사용하여 프로젝트에 대한 Data Federation 쿼리 제한을 나열하려면 다음 명령을 실행합니다.
atlas dataFederation queryLimits list [options]
Atlas CLI를 사용하여 지정한 Data Federation 쿼리 제한에 대한 세부 정보를 반환하려면 다음 명령을 실행합니다.
atlas dataFederation queryLimits describe <name> [options]
이전 명령의 구문 및 매개변수에 대해 자세히 알아보려면 Atlas CLI Atlas dataFederation queryLimits 목록 및 Atlas dataFederation queryLimits 설명 에대한 설명서를 참조하세요.
연합 데이터베이스 인스턴스 및 프로젝트의 모든 연합 데이터베이스 인스턴스에 대한 제한을 보려면 Manage Query Limits 을 클릭합니다.
Data Federation Query Limits 페이지에 다음이 표시됩니다.
열 이름 | 열 설명 |
|---|---|
Limit for | 프로젝트 에 대한 제한인 경우 프로젝트 의 이름을 지정하고, 연합 데이터베이스 인스턴스에 대한 제한인 경우 연합 데이터베이스 인스턴스 의 이름을 지정 인스턴스. |
Data Processed / Limit | 쿼리로 처리된 데이터의 총량을 나타냅니다. 처리된 데이터 위로 마우스를 가져가면 다음을 볼 수 있습니다.
|
Limit Type | 제한 유형을 나타냅니다. 값은 다음과 같습니다.
|
Terminate Queries | Atlas Data Federation 이 제한에 도달하면 실행 쿼리를 종료하는 플래그를 활성화할지 여부를 나타냅니다. |
Actions |
API 에서 쿼리 제한을 조회 하려면 limits 엔드포인트에 GET 요청 을 보냅니다.
프로젝트 의 모든 연합 데이터베이스 인스턴스에 적용되는 제한 하나를 조회 하려면 프로젝트 의 고유 ID 와 조회 할 제한의 이름을 지정해야 합니다. 하나의 프로젝트 제한을 검색하기 위한 구문 및 옵션에 학습 보려면 API 를 참조하세요. 프로젝트에 대한 모든 제한을 조회 하려면 프로젝트 의 고유 ID 를 지정 프로젝트. 모든 연합 데이터베이스 인스턴스 제한을 검색하기 위한 구문 및 옵션에 학습 보려면 API 를 참조하세요.
To retrieve one limit for one federated database instance in a project, specify the unique ID of the project, the name of federated database instance, and the name of the limit to retrieve. To learn more about the syntax and options for retrieving one limit for one federated database instance in a project, see API. To retrieve all limits for a federated database instance in a project, specify the unique ID of the project and the name of the federated database instance. To learn more about the syntax and options for retrieving all federated database instance limits, see API.
쿼리 제한 편집
Atlas UI 및 API에서 프로젝트 및 연합 데이터베이스 인스턴스별 한도를 편집할 수 있습니다.
다음을 필요에 따라 변경합니다.
다음 설정 중 하나를 수정할 수 있습니다.
필드 이름 | 설명 |
|---|---|
Limit Amount | 제한할
|
Terminate Queries | 쿼리 종료를 활성화하려면 토글합니다. 이 제한 유형의 경우 Atlas Data Federation은 기본적으로 제한에 도달하는 즉시 각 쿼리를 종료하려고 시도하기 때문에 쿼리 별 제한 유형에 대해서는 쿼리 종료를 활성화할 수 없습니다. 다른 유형에 대해 쿼리 종료를 허용하는 경우 Atlas Data Federation은 한도에 도달한 실행 중인 쿼리를 종료합니다. 종료를 비활성화하면 Atlas Data Federation은 종료된 쿼리를 다시 시작하지 않으며 Atlas Data Federation이 한도에 도달할 때 새 쿼리 또는 실행 중인 쿼리를 종료하지 않습니다. 대신 실행 중인 쿼리가 추가 데이터를 완료하고 스캔할 수 있습니다. To learn more, see What Happens When You Enable Query Termination?. |
API 에서 쿼리 제한을 수정하려면 limits 엔드포인트에 PATCH 요청 을 보냅니다.
프로젝트 의 모든 연합 데이터베이스 인스턴스에 적용되는 제한 하나를 업데이트 하려면 프로젝트 의 고유 ID 와 업데이트 할 제한의 이름을 지정해야 합니다. 하나의 프로젝트 제한을 업데이트하기 위한 구문 및 옵션에 학습 보려면 API 를 참조하세요.
프로젝트 에서 하나의 연합 데이터베이스 인스턴스 에 대한 제한 하나를 업데이트 하려면 프로젝트 의 고유 ID , 연합 데이터베이스 인스턴스 의 이름, 업데이트 할 제한의 이름을 지정합니다. 프로젝트 에서 하나의 연합 데이터베이스 인스턴스 에 대해 하나의 제한을 업데이트하기 위한 구문 및 옵션에 학습 보려면 API 를 참조하세요.
쿼리 제한 삭제
Atlas CLI, Atlas UI 및 API에서 프로젝트 또는 연합 데이터베이스 인스턴스당 제한을 삭제할 수 있습니다.
Atlas CLI를 사용하여 프로젝트에서 지정된 Data Federation 쿼리 제한을 제거하려면 다음 명령을 실행합니다.
atlas dataFederation queryLimits delete <name> [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas dataFederation queryLimits delete.
API 에서 쿼리 제한을 삭제 하려면 limits 엔드포인트에 DELETE 요청 을 보냅니다.
To delete one limit that applies to all federated database instances in the project, you must specify the unique ID of the project and the name of the limit to delete. To learn more about the syntax and options for deleting one project limit, see API.
To delete one limit for one federated database instance in a project, specify the unique ID of the project and the name of the limit to delete. To learn more about the syntax and options for deleting one limit for one federated database instance in a project, see API.