Atlas Data Federation のクエリ制限の管理
項目一覧
Overview
フェデレーティッドデータベースインスタンスの Atlas Data Federation が処理するデータ量を制限して、コストを管理できます。 の処理データ量を制限するには、フェデレーティッドデータベースインスタンスごとおよびプロジェクト内のすべてのフェデレーティッドデータベースインスタンスに対してクエリ制限を構成できます。 構成したクエリ制限は、データ処理コストにのみ適用され、データの取得や転送などの Atlas Data Federation の他のコストには適用されません。
プロジェクトおよびフェデレーティッドデータベースインスタンスごとに、クエリごとに1 日ごと、 週 ごと、および1 か月ごとに 1 つの制限を構成できます。 Atlas Data Federation では、各タイプの各制限は、設定された他の制限から独立していると見なされます。 プロジェクトとプロジェクト内のフェデレーティッドデータベースインスタンスに対して同じタイプの制限を構成すると、Atlas Data Federation は 2 つのより制限的な制限を適用します。 制限値は 1 GiB（1024^3 バイト）から 1EiB の間でなくてはなりません。
デフォルトでは、Atlas Data Federation は、すべての新しいフェデレーティッドデータベースインスタンスに対して、1 か月あたりのデータ処理量に 100 TB の制限を設定します。
注意
Atlas Data Federation は、クラウド オブジェクト ストレージごとにプロジェクト制限を適用します。 たとえば、フェデレーティッドデータベースインスタンスが 2 つあり、1 つは Amazon Web Servicesに、もう 1 つはAzureにあるとします。 Atlas Data Federation では、フェデレーティッドデータベースインスタンスごとに最大 100 TB のスキャンが可能で、プロジェクトの合計 200 TB になります。
Atlas Data Federation がデータ制限に達したときの影響
制限タイプがクエリごとの場合、データ処理量が構成された制限量に達すると、Atlas Data Federation は制限に達したクエリのデータ処理を停止します。 他のタイプの制限の場合、Atlas Data Federation は構成された制限タイプに基づいて制限がリセットされるまで、新しいクエリを実行しません。 つまり、Atlas Data Federation は次のまで新しいクエリを実行しません。
1 日あたり
00:00の制限タイプ の UTC から始まる次の暦日。週 あたり
00:00の制限タイプ の場合、月曜日 UTC に始まる次の暦週。月の最初の日（1日）から始まる次の暦月は、 月 ごと
00:00の制限タイプ の UTC で始まります。
プロジェクトとプロジェクト内のフェデレーティッドデータベースインスタンスの両方に同じタイプの制限を構成しているが、プロジェクトとプロジェクト内のフェデレーティッドデータベースインスタンスの制限値が異なる場合は、次の状況が適用されます。
Atlas Data Federation がプロジェクト内の任意のフェデレーティッドデータベースインスタンスの制限値に達する前にプロジェクトの制限値に達した場合、Atlas Data Federation はプロジェクト内のすべてのフェデレーティッドデータベースインスタンスに対して実行中のクエリをすべて完了できるようにします。
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 は結果を返さず、エラーのみを返します。 ただし、 制限に達する前に Atlas Data Federation が処理したデータ量のデータ処理料金が表示されます。
プロジェクトとプロジェクト内のフェデレーティッドデータベースインスタンスの両方に同じタイプの制限を構成しているが、制限値とクエリ終了設定が異なる場合、Atlas Data Federation は、Atlas Data Federation が処理するデータ量が次の値に達した場合にのみクエリを終了します。クエリの終了に関連付けた制限値。
例
終了が有効になっている場合は 100 GBあたりのプロジェクト制限であり、終了が無効になっている場合は 60 GB のフェデレーティッドデータベースインスタンスの制限があるとします。
フェデレーティッドデータベースインスタンスに対する 1 つ以上のクエリが 60 GB の制限に達すると、Atlas Data Federation はフェデレーティッドデータベースインスタンスに対して実行中のクエリをすべて終了し、新しいクエリを実行しません。 Atlas Data Federation は、Atlas Data Federation がプロジェクトの制限である 100 GB に達するまで、実行中のすべてのクエリと新しいクエリをプロジェクト内の他のフェデレーティッドデータベースインスタンスに対して実行し続けます。
プロジェクトの 1 つ以上のクエリが 100 GB の制限に達すると、Atlas Data Federation は新しいクエリを実行せず、プロジェクト内のすべてのフェデレーティッドデータベースインスタンスに対するすべてのクエリを終了します。
必要なアクセス権
クエリ制限を追加、編集、または削除するには、プロジェクトに対するProject Ownerアクセス権が必要です。 Organization Ownerアクセスを持つユーザーは、クエリ制限を追加、編集、削除する前に、自分自身をProject Ownerとしてプロジェクトに追加する必要があります。
クエリの制限を表示するには、プロジェクトに対するProject Read Onlyアクセス権以上が必要です。
手順
クエリ制限を追加する
Atlas CLI、Atlas UI、 APIからクエリのデータ処理量に制限を設定できます。
Atlas CLI を使用して新しい Data Federation クエリ制限を作成するには、次のコマンドを実行します。
atlas dataFederation queryLimits create <name> [options]
コマンド構文とパラメーターについて詳しくは、 Atlas CLIドキュメントの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 | 制限する MB 、 GB 、またはTBのデータ量を指定します。 |
Terminate Queries | を切り替えてクエリ終了を有効にします。 デフォルトでは、Atlas Data Federation はこの制限タイプの制限に達するとクエリを終了するため、クエリ制限タイプ ごとにクエリ終了を有効にすることはできません。 |
APIからクエリ制限を設定するには、 POSTリクエストをlimitsエンドポイントに送信します。
プロジェクト内のすべてのフェデレーティッドデータベースインスタンスに適用する制限を構成するには、プロジェクトの一意の ID と、設定する制限の名前を指定する必要があります。 プロジェクト内のすべてのフェデレーティッドデータベースインスタンスに制限を設定する構文とオプションの詳細については、「 API 」を参照してください。
プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスの制限を構成するには、プロジェクトの一意の ID とプロジェクト内のフェデレーティッドデータベースインスタンスの名前を指定します。 プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスに制限を設定する構文とオプションの詳細については、「 API 」を参照してください。
クエリ制限の表示
Atlas CLI、Atlas UI、 APIからのクエリに対するプロジェクトとフェデレーティッドデータベースインスタンスの制限を表示できます。 また、Atlas Data Federation が 1 日あたり インスタンスごとに処理したデータ量を表示することもできます。
Atlas CLI を使用してプロジェクトの Data Federation クエリ制限を一覧表示するには、次のコマンドを実行します。
atlas dataFederation queryLimits list [options]
Atlas CLI を使用して指定した Data Federation のクエリ制限の詳細を返すには、次のコマンドを実行します。
atlas dataFederation queryLimits describe <name> [options]
前のコマンドの構文とパラメータについて詳しくは、Atlas CLI ドキュメントの「Atlas dataFederation queryLimits list 」および「Atlas dataFederation queryLimits の説明 dataFederation queryLimits describe 」を参照してください。
Manage Query Limitsプロジェクト内のすべてのフェデレーティッドデータベースフェデレーティッドデータベースインスタンスごとの制限を表示するには、 をクリックします。
Data Federation Query Limitsページには次の内容が表示されます。
列名 | 列の説明 |
|---|---|
Limit for | 制限がプロジェクトの場合はプロジェクトの名前を指定し、制限がフェデレーティッドデータベースインスタンスの場合はフェデレーティッドデータベースインスタンスの名前を指定します。 |
Data Processed / Limit | クエリによって処理されたデータの合計量を示します。 処理されたデータにマウスを置くと、次の内容が表示されます。
|
Limit Type | 制限のタイプを示します。 値は次のとおりです。
|
Terminate Queries | Atlas Data Federation が 制限に達したときに実行中のクエリを終了するフラグが有効になっているかどうかを示します。 |
Actions | 制限内で実行できるアクションを表示します。 次の操作を実行できます。 |
APIからクエリ制限を検索するには、 limitsエンドポイントにGETリクエストを送信します。
プロジェクト内のすべてのフェデレーティッドデータベースインスタンスに適用する 1 つの制限を取得するには、プロジェクトの一意の ID と取得する制限の名前を指定する必要があります。 1 つのプロジェクト制限を検索するための構文とオプションの詳細については、 APIを参照してください。 プロジェクトのすべての制限を検索するには、プロジェクトの一意の ID を指定します。 すべてのフェデレーティッドデータベースインスタンスの制限を取得するための構文とオプションの詳細については、「 API 」を参照してください。
プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスに対して 1 つの制限を取得するには、プロジェクトの一意の ID、フェデレーティッドデータベースインスタンスの名前、および取得する制限の名前を指定します。 プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスに対して 1 つの制限を取得するための構文とオプションの詳細については、 APIを参照してください。 プロジェクト内のフェデレーティッドデータベースインスタンスのすべての制限を検索するには、プロジェクトの一意の ID とフェデレーティッドデータベースインスタンスの名前を指定します。 すべてのフェデレーティッドデータベースインスタンスの制限を取得するための構文とオプションの詳細については、「 API 」を参照してください。
クエリ制限の編集
Atlas UI とAPIからプロジェクトとフェデレーティッドデータベースインスタンスごとの制限を編集できます。
必要に応じて、以下を変更します。
次の設定のいずれかを変更できます。
フィールド名 | 説明 |
|---|---|
Limit Amount | 制限する
|
Terminate Queries | を切り替えてクエリ終了を有効にします。 この制限タイプでは、Atlas Data Federation はデフォルトで制限に達するとすぐに各クエリの終了を試みるため、クエリ制限タイプ でクエリ終了を有効にすることはできません。 他のタイプのクエリ終了を有効にすると、Atlas Data Federation は制限に達した実行中のクエリを終了します。 終了を無効にすると、Atlas Data Federation は終了したクエリを再起動せず、Atlas Data Federation が 制限値に達しても新しいクエリまたは実行中のクエリを終了しません。 代わりに、実行中のクエリで追加データを終了してスキャンできます。 詳細については、 「 クエリ終了を有効にするとどうなりますか 」を参照してください。 |
APIからクエリ制限を変更するには、 limitsエンドポイントにPATCHリクエストを送信します。
プロジェクト内のすべてのフェデレーティッドデータベースインスタンスに適用される 1 つの制限を更新するには、プロジェクトの一意の ID と更新する制限の名前を指定する必要があります。 1 つのプロジェクト制限を更新するための構文とオプションの詳細については、「 API 」を参照してください。
プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスの 1 つの制限を更新するには、プロジェクトの一意の ID、フェデレーティッドデータベースインスタンスの名前、および更新する制限の名前を指定します。 プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスの 1 つの制限を更新するための構文とオプションの詳細については、「 API 」を参照してください。
削除クエリの制限
Atlas CLI、Atlas UI、 APIからプロジェクトまたはフェデレーティッドデータベースインスタンスの制限ごとに削除できます。
Atlas CLI を使用して指定した Data Federation のクエリ制限をプロジェクトから削除するには、次のコマンドを実行します。
atlas dataFederation queryLimits delete <name> [options]
コマンド構文とパラメータの詳細については、 Atlas CLIドキュメントの「 Atlas dataFederation queryLimits delete 」を参照してください。
APIからクエリ制限を削除するには、 limitsエンドポイントにDELETEリクエストを送信します。
プロジェクト内のすべてのフェデレーティッドデータベースインスタンスに適用される 1 つの制限を削除するには、プロジェクトの一意の ID と削除する制限の名前を指定する必要があります。 プロジェクト制限を 1 つ削除するための構文とオプションの詳細については、 API を参照してください。
プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスの 1 つの制限を削除するには、プロジェクトの一意の ID と削除する制限の名前を指定します。 プロジェクト内の 1 つのフェデレーティッドデータベースインスタンスの 1 つの制限を削除するための構文とオプションの詳細については、 API を参照してください。