サンプルデータのインポート

このドキュメントでは、UI 経由でサンプルデータをTiDB Cloudにインポートする方法について説明します。使用するサンプルデータは、Capital Bikeshare データライセンス契約に基づいてリリースされた Capital Bikeshare のシステムデータです。サンプルデータをインポートする前に、1 つの TiDB クラスターが必要です。

Amazon S3
Google Cloud

ターゲットクラスターのインポートページを開きます。
1. TiDB Cloudコンソールにログインし、プロジェクトのクラスターページに移動します。
  ヒント：
  複数のプロジェクトがある場合は、左下隅にあるをクリックして、別のプロジェクトに切り替えます。
2. ターゲットクラスターの名前をクリックして概要ページに移動し、左側のナビゲーションペインで[インポート]をクリックします。
S3 からデータをインポートを選択します。
このクラスターにデータを初めてインポートする場合は、 「Amazon S3 からのインポート」を選択します。
「Amazon S3 からのデータのインポート」ページで、次のソースデータ情報を設定します。
- インポートファイル数: サンプルデータの場合は、複数のファイルを選択します。
- 含まれるスキーマファイル: サンプルデータの場合は、 [はい]を選択します。
  - ソースからスキーマとデータをインポートするには、 [はい]を選択します。このオプションは、テーブルを作成するための SQL スクリプトをインポートし、S3 に保存されている対応するテーブルデータを TiDB にインポートします。
  - 事前に作成されたテーブルにインポートするには、 [いいえ]を選択します。これにより、TiDB に事前にテーブルを作成し、データをインポートするテーブルを選択できます。この場合、インポートするテーブルを最大 1000 個選択できます。左側のナビゲーションペインで[SQL エディター] をクリックして、テーブルを作成できます。SQL エディターの使用方法の詳細については、 AI支援SQLエディターでデータを探索参照してください。
- データ形式: SQLを選択します。TiDB TiDB Cloud は、 .gzip 、 .gz 、 .zstd 、 .zst 、 .snappyの形式の圧縮ファイルのインポートをサポートしています。圧縮された SQL ファイルをインポートする場合は、ファイルに${db_name}.${table_name}.${suffix}.sql.${compress}形式で名前を付けます。16 ${suffix}オプションで、「000001」などの任意の整数にすることができます。たとえば、 trips.000001.sql.gzファイルをbikeshare.tripsテーブルにインポートする場合は、ファイルの名前をbikeshare.trips.000001.sql.gzに変更できます。圧縮する必要があるのはデータファイルのみであり、データベースファイルやテーブルスキーマファイルは圧縮する必要がないことに注意してください。Snappy 圧縮ファイルは公式Snappyフォーマットである必要があります。Snappy 圧縮の他のバリアントはサポートされていません。
- フォルダー URIまたはファイル URI : サンプルデータ URI s3://tidbcloud-sample-data/data-ingestion/を入力します。
- バケットアクセス: サンプルデータの場合、バケットにアクセスするにはロール ARN のみを使用できます。独自のデータの場合は、AWS アクセスキーまたはロール ARN のいずれかを使用してバケットにアクセスできます。
  - AWS ロール ARN : arn:aws:iam::801626783489:role/import-sample-accessと入力します。
  - AWS アクセスキー: サンプルデータの場合はこのオプションをスキップします。
バケットのリージョンがクラスターと異なる場合は、クロスリージョンのコンプライアンスを確認してください。
[接続] > [インポートの開始]をクリックします。

ターゲットクラスターのインポートページを開きます。
1. TiDB Cloudコンソールにログインし、プロジェクトのクラスターページに移動します。
  ヒント：
  複数のプロジェクトがある場合は、左下隅にあるをクリックして、別のプロジェクトに切り替えます。
2. ターゲットクラスターの名前をクリックして概要ページに移動し、左側のナビゲーションペインで[インポート]をクリックします。
右上隅の「データのインポート」をクリックします。
このクラスタにデータを初めてインポートする場合は、 [GCS からのインポート]を選択します。
GCS からのデータのインポートページで、次のソースデータ情報を設定します。
- インポートファイル数: サンプルデータの場合は、複数のファイルを選択します。
- 含まれるスキーマファイル: サンプルデータの場合は、 [はい]を選択します。
  - ソースからスキーマとデータをインポートするには、 [はい]を選択します。このオプションは、テーブルを作成するための SQL スクリプトをインポートし、S3 に保存されている対応するテーブルデータを TiDB にインポートします。
  - 事前に作成されたテーブルにインポートするには、 [いいえ]を選択します。これにより、TiDB に事前にテーブルを作成し、データをインポートするテーブルを選択できます。この場合、インポートするテーブルを最大 1000 個選択できます。左側のナビゲーションペインで[SQL エディター] をクリックして、テーブルを作成できます。SQL エディターの使用方法の詳細については、 AI支援SQLエディターでデータを探索参照してください。
- データ形式: SQLを選択します。TiDB TiDB Cloud は、 .gzip 、 .gz 、 .zstd 、 .zst 、 .snappyの形式の圧縮ファイルのインポートをサポートしています。圧縮された SQL ファイルをインポートする場合は、ファイルに${db_name}.${table_name}.${suffix}.sql.${compress}形式で名前を付けます。 ${suffix}オプションで、「000001」などの任意の整数にすることができます。たとえば、 trips.000001.sql.gzファイルをbikeshare.tripsテーブルにインポートする場合は、ファイル名をbikeshare.trips.000001.sql.gzに変更できます。圧縮する必要があるのはデータファイルのみであり、データベーススキーマファイルやテーブルスキーマファイルは圧縮する必要がないことに注意してください。圧縮する必要があるのはデータファイルのみであり、データベーススキーマファイルやテーブルスキーマファイルは圧縮する必要がないことに注意してください。Snappy 圧縮ファイルは公式Snappyフォーマットである必要があります。Snappy 圧縮の他のバリアントはサポートされていません。
- フォルダー URIまたはファイル URI : サンプルデータ URI gs://tidbcloud-samples-us-west1/を入力します。
- バケットアクセス: GCS IAMロールを使用してバケットにアクセスできます。詳細については、 GCS アクセスを構成する参照してください。
バケットのリージョンがクラスターと異なる場合は、クロスリージョンのコンプライアンスを確認してください。
[接続] > [インポートの開始]をクリックします。

データのインポートの進行状況が「完了」と表示されたら、サンプルデータとデータベーススキーマがTiDB Cloudのデータベースに正常にインポートされています。

クラスターがデータのインポートプロセスを完了すると、データベースにサンプルデータが取得されます。

クラスターに接続した後、ターミナルでいくつかのクエリを実行して結果を確認できます。次に例を示します。

「12th & U St NW」から始まる旅行記録を取得します。

use bikeshare;

select * from `trips` where start_station_name='12th & U St NW' limit 10;

+-----------------+---------------+---------------------+---------------------+--------------------+------------------+-------------------------------------------+----------------+-----------+------------+-----------+------------+---------------+
| ride_id         | rideable_type | started_at          | ended_at            | start_station_name | start_station_id | end_station_name                          | end_station_id | start_lat | start_lng  | end_lat   | end_lng    | member_casual |
+-----------------+---------------+---------------------+---------------------+--------------------+------------------+-------------------------------------------+----------------+-----------+------------+-----------+------------+---------------+
| E291FF5018      | classic_bike  | 2021-01-02 11:12:38 | 2021-01-02 11:23:47 | 12th & U St NW     |            31268 | 7th & F St NW / National Portrait Gallery |          31232 | 38.916786 |  -77.02814 |  38.89728 | -77.022194 | member        |
| E76F3605D0      | docked_bike   | 2020-09-13 00:44:11 | 2020-09-13 00:59:38 | 12th & U St NW     |            31268 | 17th St & Massachusetts Ave NW            |          31267 | 38.916786 |  -77.02814 | 38.908142 |  -77.03836 | casual        |
| FFF0B75414      | docked_bike   | 2020-09-28 16:47:53 | 2020-09-28 16:57:30 | 12th & U St NW     |            31268 | 17th St & Massachusetts Ave NW            |          31267 | 38.916786 |  -77.02814 | 38.908142 |  -77.03836 | casual        |
| C3F2C16949      | docked_bike   | 2020-09-13 00:42:03 | 2020-09-13 00:59:43 | 12th & U St NW     |            31268 | 17th St & Massachusetts Ave NW            |          31267 | 38.916786 |  -77.02814 | 38.908142 |  -77.03836 | casual        |
| 1C7EC91629      | docked_bike   | 2020-09-28 16:47:49 | 2020-09-28 16:57:26 | 12th & U St NW     |            31268 | 17th St & Massachusetts Ave NW            |          31267 | 38.916786 |  -77.02814 | 38.908142 |  -77.03836 | member        |
| A3A38BCACA      | classic_bike  | 2021-01-14 09:52:53 | 2021-01-14 10:00:51 | 12th & U St NW     |            31268 | 10th & E St NW                            |          31256 | 38.916786 |  -77.02814 | 38.895912 |  -77.02606 | member        |
| EC4943257E      | electric_bike | 2021-01-28 10:06:52 | 2021-01-28 10:16:28 | 12th & U St NW     |            31268 | 10th & E St NW                            |          31256 | 38.916843 | -77.028206 |  38.89607 |  -77.02608 | member        |
| D4070FBFA7      | classic_bike  | 2021-01-12 09:50:51 | 2021-01-12 09:59:41 | 12th & U St NW     |            31268 | 10th & E St NW                            |          31256 | 38.916786 |  -77.02814 | 38.895912 |  -77.02606 | member        |
| 6EABEF3CAB      | classic_bike  | 2021-01-09 15:00:43 | 2021-01-09 15:18:30 | 12th & U St NW     |            31268 | 1st & M St NE                             |          31603 | 38.916786 |  -77.02814 | 38.905697 | -77.005486 | member        |
| 2F5CC89018      | electric_bike | 2021-01-02 01:47:07 | 2021-01-02 01:58:29 | 12th & U St NW     |            31268 | 3rd & H St NE                             |          31616 | 38.916836 |  -77.02815 |  38.90074 |  -77.00219 | member        |
+-----------------+---------------+---------------------+---------------------+--------------------+------------------+-------------------------------------------+----------------+-----------+------------+-----------+------------+---------------+

電動自転車での旅行記録を取得:

use bikeshare;

select * from `trips` where rideable_type="electric_bike" limit 10;

+------------------+---------------+---------------------+---------------------+----------------------------------------+------------------+-------------------------------------------------------+----------------+-----------+------------+-----------+------------+---------------+
| ride_id          | rideable_type | started_at          | ended_at            | start_station_name                     | start_station_id | end_station_name                                      | end_station_id | start_lat | start_lng  | end_lat   | end_lng    | member_casual |
+------------------+---------------+---------------------+---------------------+----------------------------------------+------------------+-------------------------------------------------------+----------------+-----------+------------+-----------+------------+---------------+
| AF15B12839DA4367 | electric_bike | 2021-01-23 14:50:46 | 2021-01-23 14:59:55 | Columbus Circle / Union Station        |            31623 | 15th & East Capitol St NE                             |          31630 |   38.8974 |  -77.00481 | 38.890    | 76.98354   | member        |
| 7173E217338C4752 | electric_bike | 2021-01-15 08:28:38 | 2021-01-15 08:33:49 | 37th & O St NW / Georgetown University |            31236 | 34th St & Wisconsin Ave NW                            |          31226 | 38.907825 | -77.071655 | 38.916    | -77.0683   | member        |
| E665505ED621D1AB | electric_bike | 2021-01-05 13:25:47 | 2021-01-05 13:35:58 | N Lynn St & Fairfax Dr                 |            31917 | 34th St & Wisconsin Ave NW                            |          31226 |  38.89359 |  -77.07089 | 38.916    | 77.06829   | member        |
| 646AFE266A6375AF | electric_bike | 2021-01-16 00:08:10 | 2021-01-16 00:35:58 | 7th St & Massachusetts Ave NE          |            31647 | 34th St & Wisconsin Ave NW                            |          31226 | 38.892235 | -76.996025 |  38.91    | 7.068245   | member        |
| 40CDDA0378E45736 | electric_bike | 2021-01-03 11:14:50 | 2021-01-03 11:26:04 | N Lynn St & Fairfax Dr                 |            31917 | 34th St & Wisconsin Ave NW                            |          31226 | 38.893734 |  -77.07096 | 38.916    | 7.068275   | member        |
| E0A7DDB0CE680C01 | electric_bike | 2021-01-05 18:18:17 | 2021-01-05 19:04:11 | Maine Ave & 7th St SW                  |            31609 | Smithsonian-National Mall / Jefferson Dr & 12th St SW |          31248 | 38.878727 |  -77.02304 |   38.8    | 7.028755   | casual        |
| 71BDF35029AF0039 | electric_bike | 2021-01-07 10:23:57 | 2021-01-07 10:59:43 | 10th & K St NW                         |            31263 | East West Hwy & Blair Mill Rd                         |          32019 |  38.90279 |  -77.02633 | 38.990    | 77.02937   | member        |
| D5EACDF488260A61 | electric_bike | 2021-01-13 20:57:23 | 2021-01-13 21:04:19 | 8th & H St NE                          |            31661 | 15th & East Capitol St NE                             |          31630 |  38.89985 | -76.994835 |  38.88    | 76.98345   | member        |
| 211D449363FB7EE3 | electric_bike | 2021-01-15 17:22:02 | 2021-01-15 17:35:49 | 7th & K St NW                          |            31653 | 15th & East Capitol St NE                             |          31630 |  38.90216 |   -77.0211 |  38.88    | 76.98357   | casual        |
| CE667578A7291701 | electric_bike | 2021-01-15 16:55:12 | 2021-01-15 17:38:26 | East West Hwy & 16th St                |            32056 | East West Hwy & Blair Mill Rd                         |          32019 | 38.995674 |  -77.03868 | 38.990    | 77.02953   | casual        |
+------------------+---------------+---------------------+---------------------+----------------------------------------+------------------+-------------------------------------------------------+----------------+-----------+------------+-----------+------------+---------------+

サンプルデータのインポート

このページは役に立ちましたか？