すべてのプロダクト
Search

このプロダクト

    Data Management:SQL 結果セットのエクスポート

    ドキュメントセンター

    Data Management:SQL 結果セットのエクスポート

    最終更新日:Jun 14, 2025

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

    前提条件

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

      データベースタイプ

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

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

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

        • PostgreSQL: ApsaraDB RDS for PostgreSQL、PolarDB for PostgreSQL、ApsaraDB MyBase for PostgreSQL、およびその他のソースからの PostgreSQL データベース

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

        • OceanBase: MySQL モードの ApsaraDB for OceanBase、Oracle モードの ApsaraDB for OceanBase、およびセルフマネージド OceanBase データベース

        • PolarDB for PostgreSQL (Oracle 互換)

        • Oracle

        • Dameng (DM)

        • Db2

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

      • データウェアハウス: AnalyticDB for MySQL、AnalyticDB for PostgreSQL、Data Lake Analytics (DLA)、ApsaraDB for ClickHouse、MaxCompute、および Hologres

    • 詳細については、「DMS にターゲットデータベースインスタンスを登録する」をご参照ください。エクスポートするデータは、データベースインスタンスのデータベースに含まれています。

    使用上の注意

    • SQL 結果セットのエクスポート機能には、データベースインスタンスの 制御モード に基づいて制限が課せられます。 このような制限には、無料でエクスポートできる最大行数や、一度にエクスポートできるテーブルの最大容量などが含まれます。

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

    手順

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

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

      説明

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

    3. チケット申請ページで、次の表に記載されているパラメータを構成します。

      説明

      この例では、セキュリティコラボレーションモードで管理されている ApsaraDB RDS for MySQL インスタンスを使用しています。 他のタイプのデータベース用に構成する必要があるパラメータは、この例の パラメータとは若干異なります。

      パラメータ

      必須

      説明

      [データベース名]

      はい

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

      説明

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

      [理由カテゴリ]

      はい

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

      [ビジネス背景]

      はい

      このエクスポートの目的または目標。 これにより、不要なコミュニケーションを減らすことができます。

      [影響を受ける行]

      はい

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

      説明

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

      [検証をスキップ]

      いいえ

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

      警告

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

      [利害関係者]

      いいえ

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

      [エクスポートステートメント]

      はい

      実行できる SQL 文。 例: SELECT * FROM testtable。 DMS は、チケットを送信するときに SQL 文の構文を確認します。 チケットは、構文が有効な場合にのみ送信できます。

      説明

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

      [透かしを埋め込む]

      はい

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

      • [はい]

      • [いいえ]

      [埋め込み方法]

      はい

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

      • [データ透かし]: 識別情報は、データユーザーが透かしに気づかない方法でデータに埋め込まれます。

      • [ファイル透かし]: 識別情報は、データユーザーが透かしに気づく方法でエクスポートされたファイルに埋め込まれます。

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

      はい

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

      [データ透かしメッセージ]

      はい

      データに埋め込む透かしの内容。

      [埋め込みフィールド]

      いいえ

      透かしを埋め込むフィールド。

      説明

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

      [プライマリキー / ユニークキー]

      いいえ

      1 つ以上のプライマリキーまたはユニークキー。 複数のキーはコンマ (,) で区切ります。

      説明

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

      [添付ファイル]

      いいえ

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

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

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

    5. [承認のために送信] をクリックし、承認を待ちます。

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

      重要

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

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

    7. [エクスポート設定] ダイアログボックスで、次の表に記載されているパラメータを構成します。

      パラメータ

      説明

      [フォーマット]

      必須。 エクスポートするファイルのフォーマット。 有効な値: [CSV]、[EXCEL]、[SQL]、および [JSON]。 JSON フォーマットは、NoSQL データベースでのみ使用できます。

      説明

      [透かしを埋め込む] パラメータを [はい] に設定した場合は、このパラメータを [EXCEL] に設定します。

      このパラメータは、[エクスポートされた SQL 結果セットの透かし] が有効になっている場合は使用できません。 [O&M] > [構成管理] を選択して、この 設定項目 を無効にしてから、エクスポート操作を再実行できます。

      [文字セット]

      必須。 エクスポートするファイルの文字セット。 有効な値: [デフォルトの文字セット]、[GBK]、[UTF-8]、および [ISO-8859-1]。

      [実行戦略]

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

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

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

        説明

        このパラメータを [スケジュール] に設定して構成を確認した後、構成を変更することはできません。

      [エクスポートモード]

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

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

      • [通常モード]: このモードを選択した場合、エクスポートタスクはエクスポート中に終了できます。

      [エクスポート時間]

      エクスポートタスクのタイムアウト期間。 単位: 秒。 有効な値: 0 ～ 2147483。 このパラメータを指定しない場合、インスタンスレベルのエクスポートタイムアウト期間が使用されます。 インスタンスレベルのエクスポートタイムアウト期間を表示する方法については、「Alibaba Cloud データベースインスタンスを登録する」をご参照ください。

      説明

      タスクの実行期間がこのパラメータで指定されたエクスポートタイムアウト期間を超え、エクスポートタスクが完了していない場合、タスクは失敗します。

      [フィールドコメントを追加] (オプション)

      このパラメータは、データベースタイプが MySQL で、エクスポート形式が CSV の場合にのみ使用できます。 このスイッチをオンにすると、DMS はエクスポート結果のフィールド名の隣の行にフィールドコメントを追加します。

      説明

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

    8. ファイルがエクスポートされた後、[エクスポートされたファイルをダウンロード] をクリックして、ファイルをローカルマシンにダウンロードします。

      重要

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