Cloud にファイルをアップロードする

Cloud にファイルをアップロードする方法

ClickHouse Cloud では、ファイルを簡単にインポートでき、以下の フォーマットをサポートしています。

Format
CSV
CSVWithNamesAndTypes
CSVWithNames
JSONEachRow
TabSeparated
TabSeparatedWithNames
TabSeparatedWithNamesAndTypes

1. ​

   ファイルをアップロードする

   Cloud のホーム画面で、以下のようにサービスを選択します。

   サービスがアイドル状態の場合は、起動する必要があります。

   以下のように、左側のタブで Data sources を選択します。

   次に、data sources ページの右側で Upload a file を選択します。

   ファイル選択ダイアログが表示され、Cloud サービス上のテーブルにデータを 挿入するためのファイルを選択できます。

2. ​

   テーブルを設定する

   ファイルのアップロードが完了すると、データの挿入先となるテーブルを 設定できます。先頭 3 行を含むテーブルのプレビューも表示されます。

   次に、宛先テーブルを選択できます。選択肢は次のとおりです。

   • 新しいテーブル
   • 既存のテーブル

   
   

   データのアップロード先データベースを指定でき、新しいテーブルの場合は、 作成するテーブル名も指定できます。また、ソートキーも選択できます。

   ファイルから読み取られたカラムは Source field として表示され、各フィールドについて 次の項目を変更できます。

   • 推定された型
   • デフォルト値
   • カラムを Nullable にするかどうか

   フィールドの除外

   インポートに含めたくない場合は、フィールドを削除することもできます。

   使用するテーブルエンジンの種類を指定できます。

   • MergeTree
   • ReplacingMergeTree
   • SummingMergeTree
   • Null

   
   

   パーティションキー式とプライマリ キー式を指定できます。

   データをインポートするには、Import to ClickHouse (上図参照) をクリックします。データのインポートはキューに追加され、 以下に示すように Status カラムの queued ステータスバッジで確認できます。また、 Open as query (上図参照) をクリックすると、SQL コンソールで INSERT クエリを開くこともできます。このクエリは、 URL table function を使用して S3 バケットにアップロードされたファイルを挿入します。

   ジョブが失敗すると、Data upload history タブの Status カラムに failed ステータスバッジが表示されます。View Details をクリックすると、 アップロードが失敗した理由の詳細を確認できます。失敗した INSERT のエラーメッセージに基づいて、 テーブル設定を修正したり、データをクリーンアップしたりする必要がある場合があります。