Data Management (DMS) の SQL コンソールは、データクエリと開発のためのブラウザベースの SQL エディターです。DMS コンソールから離れることなく、データベースインスタンスに接続し、SQL ステートメントを作成・実行し、結果を表示できます。
前提条件
開始する前に、以下を確認してください：
アクセスするデータベースまたはテーブルに対するクエリ権限
権限を申請する方法については、「権限の管理」をご参照ください。
SQL コンソールのインターフェイス
SQL コンソールのページは、次の 4 つのセクションに分かれています：
| セクション | 説明 |
|---|---|
| ① ビジュアル操作セクション | データベースインスタンスを参照・管理します。左側のパネルで、テーブル、プログラマブルオブジェクト、キーと値のペアを表示します。 |
| ② 拡張機能セクション | 権限、テーブルリスト、データ分析、Database Autonomy Service (DAS) 診断、メタデータ同期、エクスポート、操作監査、共有、スーパー SQL モードのアイコンにアクセスします。 |
| ③ ステートメント実行セクション | SQL ステートメントを作成・実行します。コードのフォーマット、実行計画の生成、複数の SQL コンソールタブを開くことができます。 |
| ④ 実行結果セクション | クエリ結果の表示、個々の行の検査、データの追加、変更、削除ができます。[実行履歴] タブから実行履歴にアクセスします。 |
ビジュアル操作セクション (①)
ビジュアル操作セクションでは、SQL を記述することなくデータベースインスタンスを探索できます：
[テーブル]：現在のデータベースインスタンス内のすべてのテーブル (列、列の型、インデックスを含む) を表示します。テーブルを右クリックして、スキーマの変更、管理、データのインポートまたはエクスポート、バッチ操作を実行できます。
[プログラマブルオブジェクト]：ビュー、ストアドプロシージャ、関数、トリガー、イベントなどのデータベースオブジェクトを作成、表示、実行、管理します。
最大 1,000 件のエントリが表示されます。
[キーと値のペア情報]：NoSQL データベースインスタンスの場合にのみ表示されます。
拡張機能セクション (②)
拡張機能セクションでは、次のツールに素早くアクセスできます：
| アイコン | 機能 | 説明 |
|---|---|---|
 | 権限 | データ所有権、または現在のデータベースインスタンスに対する DDL、DML、SELECT 権限の変更を申請します。 |
 | テーブルリスト | [テーブルリスト] ページで、現在のデータベースインスタンス内のすべてのテーブルを表示します。 をクリックして [SQL コンソール] タブに戻ります。 |
 | データ分析 | データ分析チケットを作成します。ApsaraDB RDS for MySQL インスタンスの場合にのみ表示されます。「データウェアハウスの作成」をご参照ください。 |
 | Database Autonomy Service (DAS) | ワンクリック診断の実行、リアルタイムパフォーマンスのモニタリング、インスタンスセッションの管理、空間分析を実行します。「リアルタイムパフォーマンスモニタリング」および「セッション管理」をご参照ください。 |
 | メタデータの同期 | データベースインスタンスの最新のメタデータ (テーブル、フィールド、インデックス、プログラマブルオブジェクト) を収集します。「メタデータ」をご参照ください。 |
 | エクスポート | データ、テーブルスキーマ、またはテーブル作成ステートメントをエクスポートします。バージョン管理を使用して、スキーマのバージョン履歴を表示します。「スキーマバージョンの管理」をご参照ください。 |
 | 操作監査 | SQL の種類、各操作を実行したユーザー、タイムスタンプなど、すべてのデータクエリと変更レコードを表示します。また、リスク監査機能にアクセスして、データベースの使用リスクを評価することもできます。「操作監査機能の使用」および「リスク監査レポートの生成」をご参照ください。 |
 | 共有 | SQL コンソールタブとそのステートメントを他の関係者と共有します。「SQL コンソールタブの共有」をご参照ください。 |
 | スーパー SQL モード | セキュリティルールの制限なしで SQL ステートメントを実行します。DMS 管理者およびデータベース管理者 (DBA) が利用できます。「スーパー SQL モードの使用」をご参照ください。 |
ステートメント実行セクション (③)
ステートメント実行セクションは、SQL を作成・実行する場所です。次の 3 つのコントロールがあります：
[実行]：エディターに入力された SQL ステートメントを実行します。
[フォーマット]：SQL を読みやすく再フォーマットします。たとえば、
SELECT * FROM 'test_table';は次のようになります：SELECT * FROM `test_table`;[実行計画]：入力した SQL ステートメントをシステムがどのように実行するかを表示します。
右上隅の 
をクリックすると、複数の SQL コンソールタブを開くことができます。
SQL コンソールを開く
DMS コンソール V5.0 にログインします。
上部のナビゲーションバーで、[SQL コンソール] > [SQL コンソール] を選択します。
コンソールがシンプルモードの場合は、左上隅の
をクリックし、[すべての機能] > [SQL コンソール] > [SQL コンソール] を選択します。[データベースの選択] ダイアログボックスで、データベースインスタンスを検索し、結果から選択して [確認] をクリックします。
[SQL コンソール] タブで SQL ステートメントを入力し、[実行] をクリックします。
制限事項
SQL コンソールを使用する際は、次の制限事項にご注意ください：
クエリ行数の制限：DMS 管理者は、クエリごとに返される最大行数を変更できます。変更するには、[セキュリティと仕様] > [セキュリティルール] に移動し、該当するセキュリティルールを編集して [SQL コンソール] タブを開き、チェックポイントとして [基本設定項目] を選択し、クエリごとに返される最大行数の設定項目を見つけて、[操作] 列の [編集] をクリックします。
柔軟な管理または安定的な変更モードのデータベース：デフォルトでクエリごとに最大 3,000 行が返されます。
セキュリティコラボレーションモードのデータベース：デフォルトで 200 行が返され、最大 3,000 行までです。
制限を変更せずにより多くの行を取得するには、代わりにデータをエクスポートします。テーブルに機密フィールドが含まれている場合は、まずそれらのフィールドに対するエクスポート権限を申請してください。詳細については、「権限の管理」および「SQL 結果セットのエクスポート」をご参照ください。
フルテーブルスキャンのしきい値：デフォルトでは、最大 10 GB のテーブルでフルテーブルスキャンが許可されています。DMS 管理者は、[セキュリティと仕様] > [セキュリティルール] でこの値を変更できます。
クエリタイムアウト：各 SQL ステートメントのデフォルトのタイムアウトは 60 秒です。変更するには、[データ資産] > [インスタンス] に移動し、[インスタンスリスト] タブでインスタンスを見つけ、[操作] 列の [その他] にポインターを合わせ、[編集] を選択します。[編集] ダイアログボックスで、[詳細情報] セクションの クエリタイムアウト (秒) パラメーターを更新します。
機密フィールド: アクセス権限がないテーブル内の機密または秘匿フィールドの場合、そのフィールドの値はクエリ結果で
******として表示されます。詳細については、「機密データの管理」をご参照ください。
よくある質問
Q：DMS で MongoDB インスタンスにログインして SQL ステートメントを実行すると、「The instruction is incomplete. Please check.」というエラーメッセージが返されます。
A：一部の MongoDB 命令では、新しいリゾルバを有効にする必要があります。[リゾルバを開く] をクリックして、新しいリゾルバに切り替えます。新しいリゾルバでサポートされているコマンドの完全なリストについては、「サポートされている MongoDB コマンド」をご参照ください。
次のステップ
SQL コンソールのインターフェイスに慣れたら、テーブルの作成、テーブルのクエリ、またはテーブルデータの変更ができます：