サンプルデータのインポート
このドキュメントでは、UI を介してサンプル データをTiDB Cloudにインポートする方法について説明します。使用するサンプル データは、Capital Bikeshare データ ライセンス契約に基づいてリリースされた Capital Bikeshare のシステム データです。サンプル データをインポートする前に、1 つの TiDB クラスターが必要です。
- Amazon S3
- Google Cloud
ターゲット クラスターのインポートページを開きます。
TiDB Cloudコンソールにログインし、プロジェクトのクラスターページに移動します。
ヒント:
複数のプロジェクトがある場合は、
左下隅にある をクリックして、別のプロジェクトに切り替えます。 ターゲット クラスターの名前をクリックして概要ページに移動し、左側のナビゲーション ペインで[インポート] をクリックします。
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 アクセスキー: サンプルデータの場合はこのオプションをスキップします。
- AWS ロール ARN :
バケットのリージョンがクラスターと異なる場合は、クロスリージョンのコンプライアンスを確認してください。
[接続] > [インポートの開始]をクリックします。
ターゲット クラスターのインポートページを開きます。
TiDB Cloudコンソールにログインし、プロジェクトのクラスターページに移動します。
ヒント:
複数のプロジェクトがある場合は、
左下隅にある をクリックして、別のプロジェクトに切り替えます。 ターゲット クラスターの名前をクリックして概要ページに移動し、左側のナビゲーション ペインで[インポート] をクリックします。
右上隅の「データのインポート」をクリックします。
このクラスタにデータを初めてインポートする場合は、 「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 | +------------------+---------------+---------------------+---------------------+----------------------------------------+------------------+-------------------------------------------------------+----------------+-----------+------------+-----------+------------+---------------+