すべてのプロダクト
Search
ドキュメントセンター

:SQL結果セットのエクスポートExport SQL result sets

最終更新日:Sep 04, 2024

データ管理 (DMS) は、SQL結果セットのエクスポート機能を提供します。 この機能を使用して、DMSでSQL文を記述し、ビジネス要件に基づいて関連データをエクスポートできます。

前提条件

  • データベースインスタンスは、次のいずれかのタイプです。

    データベースタイプ

    • リレーショナルデータベース:

      • MySQL: ApsaraDB RDS for MySQLPolarDB for MySQLApsaraDB MyBase for MySQLPolarDB for Xscale、およびその他のソースのMySQLデータベース

      • SQL Server: ApsaraDB RDS for SQL ServerApsaraDB MyBase for SQL Server、および他のソースのSQL Serverデータベース

      • PostgreSQL: ApsaraDB RDS for PostgreSQLPolarDB for PostgreSQLApsaraDB MyBase for PostgreSQL、および他のソースのPostgreSQLデータベース

      • MariaDB: ApsaraDB RDS for MariaDBおよび他のソースのMariaDBデータベース

      • OceanBase: MySQLモードのApsaraDB for OceanBaseOracleモードのApsaraDB for OceanBase、および自己管理型OceanBaseデータベース

      • PolarDB for PostgreSQL (Oracleと互換)

      • オラクル

      • ダメン (DM)

      • Db2

    • NoSQLデータベース: ApsaraDB for MongoDBApsaraDB for Lindorm、およびApsaraDB for Cassandra

    • データウェアハウス: AnalyticDB for MySQLAnalyticDB for PostgreSQLData Lake Analytics (DLA)ApsaraDB for ClickHouseMaxComputeHologres

  • データベースインスタンスがDMSに登録されています。 エクスポートされるデータは、データベースインスタンスのデータベースに含まれています。 データベースインスタンスをDMSに登録する方法の詳細については、「Alibaba Cloudデータベースインスタンスの登録」および「サードパーティのクラウドサービスまたは自己管理データベースでホストされているデータベースの登録」をご参照ください。

使用上の注意

  • データベースインスタンスの制御モードに基づいて、SQL結果セットのエクスポート機能に制限が課されます。 このような制限には、無料でエクスポートできる行の最大数と、一度にエクスポートできるテーブルの最大容量が含まれます。 詳細については、「コントロールモード」をご参照ください。

  • 同じデータベースインスタンスの他のデータベースからデータをエクスポートするには、データをエクスポートする前に、DMSの現在のデータベースへのログインに使用するアカウントが特権アカウントであることを確認してください。 これにより、権限不足によるエクスポートの失敗を防ぎます。

手順

  1. DMSコンソールV5.0 にログインします。

  2. 上部のナビゲーションバーで、データベース开発 > データのエクスポート > SQL結果セットのエクスポートを選択します。

    説明

    データベースの [SQLConsole] タブで、リレーショナルデータベースまたはデータウェアハウスからデータをエクスポートすることもできます。 これを行うには、データベースの [SQLConsole] タブでSQL文を実行します。 次に、[ファイルのエクスポート] > [詳細データのエクスポート] を選択し、[実行結果] タブでSQL結果セットをエクスポートします。

  3. [チケットアプリケーション] ページで、次の表に示すパラメーターを設定します。

    説明

    この例では、Security Collaborationモードで管理されるApsaraDB RDS for MySQLインスタンスが使用されています。 他の種類のデータベースに対して設定する必要があるパラメーターは、この例のパラメーターとは少し異なります。

    パラメーター

    必須

    説明

    データベース名

    必須

    SQL結果セットをエクスポートするデータベース。

    説明

    データベースからSQL結果セットをエクスポートする権限が必要です。 詳細については、「所有権限の表示」をご参照ください。

    理由カテゴリ

    必須

    このエクスポートの理由。 これにより、後続の操作でチケットを見つけることができます。

    ビジネスの背景

    必須

    このエクスポートの目的または目的。 これにより、不要な通信が削減される。

    影響を受ける行

    必須

    このエクスポートの影響を受けるデータ行の推定数。 影響を受ける行の実際の数を取得するには、SQLConsoleタブのSQL文でCOUNT関数を使用します。

    説明

    事前チェックステップで、DMSは影響を受ける行の実際の数を表示します。 影響を受ける行の数が予想通りであるかどうかを確認できます。 これにより、データのセキュリティが確保されます。

    [検証のスキップ]

    任意

    検証をスキップするかどうかを指定します。 [検証のスキップ] を選択した場合、チェックボックスの下のフィールドに理由を入力する必要があります。

    警告

    [検証のスキップ] を選択した後、DMSはこのエクスポートの影響を受ける可能性のある行数をチェックしません。 大量のデータをエクスポートする場合、ビジネスに影響を与える可能性があります。 作業は慎重に行ってください。

    利害関係者

    任意

    この輸出に関与している利害関係者。 指定されたすべての利害関係者は、チケットの詳細を表示し、承認プロセスに参加できます。 DMS管理者とデータベース管理者 (DBA) 以外の関係のないユーザーは、チケットの詳細にアクセスできません。

    Export Statement

    必須

    実行可能なSQL文。 例: SELECT * FROM testtable DMSは、チケットの送信時にSQL文の構文を検証します。 チケットは、その構文が有効な場合にのみ送信できます。

    説明

    SELECT文のみがサポートされています。

    埋め込み透かし

    必須

    エクスポートしたファイルに透かしを埋め込むかどうかを指定します。 有効な値:

    • はい

    • いいえ

    埋め込み方法

    必須

    エクスポートされたファイルに透かしを埋め込む方法。 有効な値:

    • データ透かし: 識別情報は、データユーザが透かしを知覚できないようにデータに埋め込まれる。

    • ファイル透かし: 識別情報は、透かしがデータユーザーに見えるようにエクスポートされたファイルに埋め込まれます。

    ファイル透かしメッセージ

    必須

    エクスポートされたファイルに埋め込まれる透かしの内容。

    データ透かしメッセージ

    必須

    データに埋め込まれる透かしの内容。

    埋め込みフィールド

    任意

    透かしが埋め込まれるフィールド。

    説明

    フィールドを指定しない場合、DMSはデフォルトでフィールドを選択します。

    主キー /ユニークキー

    任意

    1つ以上の主キーまたは一意のキー。 複数のキーはコンマ (,) で区切ります。

    説明

    透かしの堅牢性を向上させるために、このパラメーターを指定することを推奨します。

    添付ファイル

    任意

    このエクスポートに関する詳細情報を追加するためにアップロードされる画像またはファイル。

  4. 送信 をクリックします。

    DMSはSQL文を事前にチェックします。 事前チェックが完了するまで待ちます。

  5. クリック承認のために提出そして承認を待ちます。

    チケットの詳細ページで、承認ステップで承認の進行状況を確認できます。

    重要

    チケットが承認されてから24時間以内にSQL結果セットをエクスポートする必要があります。 それ以外の場合は、SQL結果セットをエクスポートできません。 この場合、別のSQL結果セットエクスポートチケットを作成する必要があります。 SQL結果セットをエクスポートするデータベースがセキュリティコラボレーションモードで管理されている場合、チケットが承認された後にSQL結果セットをエクスポートできる期間を設定できます。 データベースインスタンスに適用されているセキュリティルールセットの [詳細] ページに移動し、左側のバーの [データのエクスポート] をクリックし、[SQL結果セットのエクスポート要求が承認された後のエクスポートの実行期間] の [操作] 列の [編集] をクリックして設定値を変更します。

  6. 実行 /自動実行ステップエクスポート をクリックします。

  7. エクスポート設定ダイアログボックスで、次の表で説明するパラメーターを設定します。

    パラメーター

    説明

    Format

    必須。 エクスポートするファイルの形式。 有効な値: CSVEXCELSQL、およびJSON。 JSON形式は、NoSQLデータベースでのみ使用できます。

    説明

    埋め込み透かしパラメーターをYesに設定した場合、このパラメーターをEXCELに設定します。

    文字セット

    必須。 エクスポートするファイルの文字セット。 有効な値: デフォルト文字セットGBKUTF-8ISO-8859-1

    実行戦略

    必須。 ファイルのエクスポートに使用される戦略。 有効な値:

    • すぐに実行: [実行の確認] をクリックすると、DMSはすぐにファイルをエクスポートします。

    • スケジュール: DMSは、指定した時点でファイルをエクスポートします。 オフピーク時間帯の時点を指定できます。

      説明

      このパラメーターをScheduleに設定し、設定を確認した後は、設定を変更できません。

    エクスポートモード

    必須。 ファイルのエクスポートモード。 有効な値:

    • 速度モード: このモードを選択した場合、エクスポートタスクは完了する前に終了できません。

    • 通常モード: このモードを選択すると、エクスポート中にエクスポートタスクを終了できます。

    説明

    DMSは設定に基づいてファイルをエクスポートします。 エクスポートの進行状況は、[実行 /自動実行] ステップで確認できます。

  8. ファイルのエクスポート後、Exported Fileのダウンロードファイルをローカルマシンにダウンロードします。

    重要

    デフォルトでは、ファイルがエクスポートされた後、いつでもエクスポートされたファイルをダウンロードできます。 SQL結果セットをエクスポートするデータベースがセキュリティコラボレーションモードで管理されている場合、エクスポートしたファイルをダウンロードできる期間を設定できます。 データベースインスタンスに適用されているセキュリティルールセットの [詳細] ページに移動し、左側のバーの [データのエクスポート] をクリックし、[SQL結果セットのエクスポート要求が承認された後のエクスポートファイルのダウンロード期間] の [操作] 列の [編集] をクリックして設定値を変更します。 たとえば、値を1に設定した場合、エクスポートされたファイルは、チケットが承認されてから1時間以内にダウンロードできます。