> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-86180b7b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<div id="upload-files-to-cloud">
  # Cloud にファイルをアップロードする
</div>

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

| Format                          |
| ------------------------------- |
| `CSV`                           |
| `CSVWithNamesAndTypes`          |
| `CSVWithNames`                  |
| `JSONEachRow`                   |
| `TabSeparated`                  |
| `TabSeparatedWithNames`         |
| `TabSeparatedWithNamesAndTypes` |

<Steps>
  <Step>
    ## ファイルをアップロードする

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_01.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=94258b64c98d0937794c989c9f83b20a" alt="upload_file_02" width="3024" height="1483" data-path="images/cloud/migrate/csv_01.png" />

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_02.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=768857b1f0d801f89e4e97c6c97f008b" alt="upload_file_03" width="3024" height="1483" data-path="images/cloud/migrate/csv_02.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_03.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=b4f9b6e1ae8b947ccc0746d9bf2ec8f4" alt="upload_file_04" width="3024" height="1483" data-path="images/cloud/migrate/csv_03.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_04.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=ab2bd39836f42eaf7bb0d85bbde5fd00" alt="upload_file_05" width="1267" height="736" data-path="images/cloud/migrate/csv_04.png" />
  </Step>

  <Step>
    ## テーブルを設定する

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_08.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=a59dfaeaf5d8c35cf950498f9d12b647" alt="upload_file_08" width="3018" height="1476" data-path="images/cloud/migrate/csv_08.png" />

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

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

    <br />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_05.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=037c2ceae81c683601fa410cdbbe64dc" alt="upload_file_05" width="3016" height="1474" data-path="images/cloud/migrate/csv_05.png" />

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

    * 推定された型
    * デフォルト値
    * カラムを [Nullable](/ja/reference/data-types/nullable) にするかどうか

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_06.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=fa3c43736fc1ad7c3ba3a464c89cce43" alt="upload_file_06" width="3012" height="1476" data-path="images/cloud/migrate/csv_06.png" />

    <Info>
      **フィールドの除外**

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

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

    * `MergeTree`
    * `ReplacingMergeTree`
    * `SummingMergeTree`
    * `Null`

    <br />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_07.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=6dd48cee4f74c04d148ca903d52a2ec2" alt="upload_file_07" width="3004" height="1476" data-path="images/cloud/migrate/csv_07.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_09.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=dbae4ab050db58624a6e533fcde30d83" alt="upload_file_09" width="1271" height="487" data-path="images/cloud/migrate/csv_09.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/kXeOHzm028vBHof0/images/cloud/migrate/csv_10.png?fit=max&auto=format&n=kXeOHzm028vBHof0&q=85&s=e59d0e727c6fd495d55ebbf422263e38" alt="upload_file_11" width="1260" height="262" data-path="images/cloud/migrate/csv_10.png" />
  </Step>
</Steps>
