SelectDB インスタンスへの接続 - ApsaraDB for SelectDB - Alibaba Cloud ドキュメントセンター

ApsaraDB for SelectDB インスタンスを作成した後、データベースやテーブルの作成などの操作を実行する前に、インスタンスに接続する必要があります。このトピックでは、可視化ツール SQL エディターを使用して SelectDB インスタンスに接続し、データベースとテーブルを作成する方法について説明します。この情報は、SelectDB インスタンスをすぐに使用するために役立ちます。データ管理 (DMS) や MySQL クライアントなどの別のクライアントを使用して SelectDB インスタンスに接続する場合は、このトピックを参照してください。

前提条件

SelectDB インスタンスが作成されていること。詳細については、「ステップ 1：SelectDB インスタンスを作成する」をご参照ください。

手順

ステップ 1：管理者アカウントのパスワードを変更する

SelectDB インスタンスを作成すると、システムによって管理者アカウントが自動的に作成されます。管理者アカウントを使用してインスタンスにログインする前に、管理者アカウントのパスワードを変更する必要があります。

SelectDB コンソールにログインし、[インスタンス] ページに移動します。上部のナビゲーションバーで、SelectDB インスタンスが存在するリージョンを選択します。次に、管理するインスタンスを見つけ、その ID をクリックします。
[インスタンスの詳細] ページで、右上隅にある [パスワードのリセット] をクリックします。
[パスワードのリセット] ダイアログボックスで、新しいパスワードを入力し、[OK] をクリックします。

ステップ 2：インスタンスに接続する

ステップ 1 を完了すると、システムは [インスタンスの詳細] ページに留まります。

[インスタンスの詳細] ページで、右上隅にある [データ開発と管理] をクリックします。
説明
[データ開発と管理] のツールを初めて使用する場合は、メッセージが表示され、マシンのパブリック IP アドレスをインスタンスの [webui_whitelist] という名前の IP アドレスホワイトリストに追加するように求められます。メッセージを読み、[OK] をクリックします。
[データ開発と管理] ドロップダウンリストから [SQL エディター] を選択して、[SQL エディター] ページに移動します。
[SQL エディター] ページが表示された場合、SelectDB インスタンスは接続されています。
説明
- SQL エディターを初めて使用し、WebUI システムにログインしていない場合は、自動的に WebUI ログインページに移動します。管理者アカウントを使用して WebUI システムにログインする必要があります。ログイン後、[SQL エディター] ページが表示されます。
- 以前に [SQL エディター] を使用し、WebUI システムにログインしている場合は、[SQL エディター] を選択すると [SQL エディター] ページが表示されます。

ステップ 3：データベースを作成する

[SQL エディター] ページで、次の文を入力して実行します。

CREATE DATABASE test_db;

ページの右側にある SQL エディターに文を入力します。
[実行（制限 1000）] をクリックします。
ページ下部の [クエリ結果] セクションに「Execute Successfully」メッセージが表示された場合、データベースが作成されています。左側のペインにある [データ] タブの右上隅にある更新アイコンをクリックして、作成されたデータベースを表示することもできます。

ステップ 4：テーブルを作成する

[SQL エディター] ページで、次の文を入力して実行します。

CREATE TABLE test_tb
(
    k1 TINYINT,
    k2 DECIMAL(10, 2) DEFAULT "10.05",
    k3 CHAR(10) COMMENT "文字列型の列", /* Japanese comment */
    k4 INT NOT NULL DEFAULT "1" COMMENT "整数型の列" /* Japanese comment */
)
COMMENT "最初のテーブル" /* Japanese comment */
DISTRIBUTED BY HASH(k1) BUCKETS 16;

文を実行するデータベースとクラスタを指定します。
ページの右側にある上部のツールバーで、2 番目のドロップダウンリストからデータベースを選択し、3 番目のドロップダウンリストからクラスタを選択します。
ページの右側にある SQL エディターに文を入力します。
[実行（制限 1000）] をクリックします。
ページ下部の [クエリ結果] セクションに「Execute Successfully」メッセージが表示された場合、テーブルが作成されています。左側のペインにある [データ] タブの右上隅にある更新アイコンをクリックして、作成されたテーブルを表示することもできます。

ステップ 5：（オプション）データをインポートしてクエリを実行する

SelectDB は複数のデータインポート方法をサポートしています。この例では、Stream Load メソッドを使用して、CSV 形式のデータを前のステップで作成した test_tb テーブルにインポートします。Stream Load の詳細については、「Stream Load を使用してデータをインポートする」をご参照ください。

IP アドレスを IP アドレスホワイトリストに追加します。
[インスタンスの詳細] ページの左側のナビゲーションウィンドウで、[データセキュリティ] をクリックします。[データセキュリティ] ページで、[ホワイトリストの作成] をクリックします。表示されるパネルで、マシンのパブリック IP アドレスを SelectDB インスタンスの IP アドレスホワイトリストに追加します。
インポートするデータを準備します。
マシン上に CSV ファイルを準備します。詳細については、「test_tb.csv」を参照してください。

データをインポートします。

マシンでコマンドラインツールを開き、curl コマンドを実行して Stream Load ジョブを開始し、データをインポートします。

構文

curl --location-trusted -u <username>:<password> [-H ""] -H "expect:100-continue" -T <file_name> -XPUT http://<host>:<port>/api/<db
_name>/<table_name>/_stream_load

パラメーター

パラメーター	説明
`--location-trusted`	認証が必要な場合、リクエストがリダイレクトされるサーバーに `username` と `password` が渡されるように指定します。
`-u`	SelectDB インスタンスに接続するために使用されるユーザー名とパスワード。
`-H`	リクエストヘッダー。次のパラメーターがサポートされています。 `label`：Stream Load ジョブの一意の識別子。 `column_separator`：インポートするファイルの列区切り文字。デフォルト値：`\t`。複数の文字の組み合わせを列区切り文字として使用することもできます。印刷不可の文字を列区切り文字として指定する場合は、プレフィックスとして `\x` を追加し、16 進数で区切り文字を指定します。
`-T`	インポートするファイルのパス。
`-XPUT`	HTTP リクエストのメソッド。この例では、PUT メソッドが使用されます。データをインポートする SelectDB インスタンスの URL を指定する必要があります。次のパラメーターがサポートされています。 `host`：SelectDB インスタンスの VPC エンドポイントまたはパブリックエンドポイント。説明コマンドを実行するマシンが、SelectDB インスタンスが存在する VPC とは異なる VPC に存在する場合は、パブリックエンドポイントを使用する必要があります。パブリックエンドポイントの申請方法については、「パブリックエンドポイントを申請またはリリースする」をご参照ください。 SelectDB インスタンスと同じ VPC に存在する Alibaba Cloud サービスでコマンドを実行する場合は、VPC エンドポイントを使用することをお勧めします。 `port`：ApsaraDB for SelectDB インスタンスの HTTP ポート番号。デフォルト値：8080。説明 SelectDB インスタンスのエンドポイントとポート番号は、SelectDB インスタンスの [インスタンスの詳細] ページで確認できます。 `db_name`：データベースの名前。 `table_name`：テーブルの名前。

サンプルコード

curl --location-trusted -u admin:07b1**** -T C:\Users\****\Downloads\test_tb.csv -H "label:test123" -H "expect:100-continue" -H"column_separator:," selectdb-cn-vc****-public.selectdbfe.rds.aliyuncs.com:8080/api/test_db/test_tb/_stream_load

インポート結果を表示します。
[SQL エディター] ページで、次の文を入力して実行します。
```
SELECT * FROM test_tb;
```
[実行（制限 1000）] をクリックします。インポートされたデータがページ下部の [クエリ結果] セクションに表示された場合、サンプルデータがインポートされています。

次のステップ

このトピックでは、SelectDB インスタンスへの接続方法、SQL エディターを使用したデータベースとテーブルの作成方法、およびストリームロードジョブを使用したデータのインポート方法について説明します。ビジネス要件を満たすデータベースとテーブルを作成する場合は、SelectDB インスタンスのデータベースとテーブル設計のキーポイントを理解することをお勧めします。これにより、ビジネスへの悪影響を防ぐために、正しいデータベースとテーブルのプロパティを迅速に選択できます。

詳細については、「ステップ 3：データベースとテーブル設計のキーポイントを学習する」をご参照ください。

ApsaraDB for SelectDB:ステップ 2：SelectDB インスタンスに接続し、データベースとテーブルを作成する