本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 教學課程：使用 cqlsh 將資料載入 Amazon Keyspaces
<a name="bulk-upload"></a>

本教學課程將引導您使用 `cqlsh COPY FROM`命令，將資料從 Apache Cassandra 遷移至 Amazon Keyspaces。`cqlsh COPY FROM` 命令有助於快速且輕鬆地將小型資料集上傳至 Amazon Keyspaces，以供學術或測試之用。如需如何遷移生產工作負載的詳細資訊，請參閱 [離線遷移程序：Apache Cassandra 到 Amazon Keyspaces](migrating-offline.md)。在本教學課程中，您將完成下列步驟：

先決條件 – 設定具有登入資料的 AWS 帳戶、建立憑證的 JKS 信任存放區檔案，以及設定 `cqlsh` 以連線至 Amazon Keyspaces。

1. **建立來源 CSV 和目標資料表** – 準備 CSV 檔案做為來源資料，並在 Amazon Keyspaces 中建立目標金鑰空間和資料表。

1. **準備資料** – 隨機化 CSV 檔案中的資料並加以分析，以判斷平均和最大資料列大小。

1. **設定輸送量容量** – 根據資料大小和所需的載入時間計算所需的寫入容量單位 (WCUs)，並設定資料表的佈建容量。

1. **設定 cqlsh 參數** – 決定`cqlsh COPY FROM`參數的最佳值`NUMPROCESSES`，例如 `INGESTRATE`、`MAXBATCHSIZE`、 和 `CHUNKSIZE`，以平均分配工作負載。

1. **執行 `cqlsh COPY FROM`命令 ** – 執行 `cqlsh COPY FROM`命令，將資料從 CSV 檔案上傳至 Amazon Keyspaces 資料表，並監控進度。

故障診斷 – 在資料上傳過程中解決常見問題，例如無效請求、剖析器錯誤、容量錯誤和 cqlsh 錯誤。

**Topics**
+ [先決條件：使用 上傳資料之前要完成的步驟 `cqlsh COPY FROM`](bulk-upload-prequs.md)
+ [步驟 1：建立來源 CSV 檔案和目標資料表以進行資料上傳](bulk-upload-source.md)
+ [步驟 2：準備來源資料以成功上傳資料](bulk-upload-prepare-data.md)
+ [步驟 3：設定資料表的輸送量容量](bulk-upload-capacity.md)
+ [步驟 4：設定`cqlsh COPY FROM`設定](bulk-upload-config.md)
+ [步驟 5：執行 `cqlsh COPY FROM`命令，將資料從 CSV 檔案上傳至目標資料表](bulk-upload-run.md)
+ [疑難排解](bulk-upload-troubleshooting.md)