本頁面由 Cloud Translation API 翻譯而成。

使用 CSV 檔案匯出及匯入
透過集合功能整理內容你可以依據偏好儲存及分類內容。

MySQL | PostgreSQL | SQL Server

本頁面說明如何使用 CSV 檔案將資料匯出至 Cloud SQL 執行個體，以及匯入資料。

事前準備

開始匯出或匯入作業前：

請確認資料庫有足夠的可用空間。

匯出和匯入作業會使用資料庫資源，但除非執行個體的資源不足，否則不會干擾一般資料庫作業。

驗證 CSV 檔案是否含有預期的資料，且格式正確無誤。CSV 檔案的每一列資料必須有一行，並有以逗號分隔的欄位。
請遵循匯出及匯入資料的最佳做法。

從 PostgreSQL 適用的 Cloud SQL 匯出資料

從 PostgreSQL 適用的 Cloud SQL 匯出資料時，所需的角色和權限

如要將資料從 Cloud SQL 匯出至 Cloud Storage，啟動匯出作業的使用者必須具備下列其中一個角色：

Cloud SQL 編輯者角色
自訂角色，包括下列權限：
- cloudsql.instances.get
- cloudsql.instances.export

此外，Cloud SQL 執行個體的服務帳戶必須具備下列其中一個角色：

storage.objectAdmin Identity and Access Management (IAM) 角色
自訂角色，包括下列權限：
- storage.objects.create
- storage.objects.list (僅限平行匯出檔案)
- storage.objects.delete (僅限平行匯出檔案)

如需有關 IAM 角色的說明，請參閱「身分與存取權管理」。

將資料從 PostgreSQL 適用的 Cloud SQL 匯出為 CSV 檔案

您可以將資料匯出為 CSV 格式，以便其他工具和環境使用。匯出作業會在資料庫層級進行。匯出 CSV 時，您可以指定要匯出的結構定義。資料庫層級的所有結構定義皆可匯出。

注意：Cloud SQL 會使用雙引號 (16 進制值「22」) 做為預設的逸出字元。對於資料庫而言，如果 NULL 的值是以字串常值輸入，就可能會發生問題。匯入使用預設逸出字元匯出的檔案時，檔案不會將值視為 NULL，而是 "NULL"。建議您在匯出檔案時使用 --escape="5C" 覆寫預設值。

如要將資料從 Cloud SQL 執行個體的資料庫匯出至 Cloud Storage 值區中的 CSV 檔案，請按照下列步驟操作：

控制台

前往 Google Cloud 控制台的「Cloud SQL 執行個體」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
按一下 [匯出]。
選取「Offload export」，允許在匯出作業進行期間執行其他作業。
在「Cloud Storage export location」(Cloud Storage 匯出位置) 部分，新增要匯出的值區、資料夾和檔案名稱，或按一下「Browse」(瀏覽)，找出或建立值區、資料夾或檔案。
如果你點選「瀏覽」：
1. 在「位置」部分，選取匯出的 Cloud Storage 值區或資料夾。
  注意：如要建立新的儲存體存放區，請在「位置」部分點選帶有「+」符號的存放區。這會開啟「建立值區」，您可以在其中為值區新增名稱和其他設定。為值區選取標準儲存空間級別。
2. 在「Name」方塊中，新增 CSV 檔案的名稱，或是從「Location」部分的清單中選取現有檔案。
  
  您可以使用 .gz 的副檔名 (完整副檔名為 .csv.gz) 壓縮匯出檔案。
3. 按一下 [選取]。
在「格式」部分，按一下「CSV」。
在「Database for export」部分，從下拉式選單中選取資料庫名稱。
針對「SQL 查詢」，請輸入 SQL 查詢，指定要匯出資料的資料表。

例如，如要匯出 guestbook 資料庫中 entries 資料表的完整內容，您可以輸入
```
SELECT * FROM guestbook.entries;
```
您的查詢必須指定指定資料庫中的資料表。您無法匯出 CSV 格式的完整資料庫。

注意： 在傳輸期間，查詢可能會在目標執行個體位置以外的中繼位置處理
按一下 [匯出] 即可開始匯出。
「Export database?」方塊會隨即開啟，並顯示一則訊息，說明匯出大型資料庫的程序可能需要一小時或更久的時間。在匯出期間，您只能對執行個體執行查看資訊的作業。匯出作業開始後，您可以取消作業。如果現在是開始匯出的最佳時機，請按一下「Export」。否則請按一下「取消」。

gcloud

建立 Cloud Storage 值區。
上傳檔案至值區。

如需將檔案上傳至值區的說明，請參閱上傳物件。
找出要匯出的 Cloud SQL 執行個體的服務帳戶。您可以執行 gcloud sql instances describe 指令來執行此操作。在輸出內容中尋找 serviceAccountEmailAddress 欄位。
```
gcloud sql instances describe INSTANCE_NAME
```
使用 gcloud storage buckets add-iam-policy-binding 將 storage.objectAdmin IAM 角色授予 Cloud SQL 執行個體服務帳戶。如需設定身分與存取權管理權限的說明，請參閱「使用身分與存取權管理權限」一文。
匯出資料庫：
注意： 如要使用無伺服器匯出功能，請使用 --offload 標記。否則，請從下列指令中移除該值。
```
gcloud sql export csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--offload \
--query=SELECT_QUERY
```
如要瞭解如何使用 export csv 指令，請參閱 sql export csv 指令參考資料頁面。

注意： 在傳輸期間，SELECT_QUERY 可能會在目標執行個體位置以外的中繼位置處理。
如果您不需要保留先前設定的 IAM 角色，請立即撤銷。

REST v1

建立匯出的值區：
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
這並不是必要的步驟，但我們強烈建議您這麼做，以避免開放其他資料的存取權限。
為執行個體提供值區的 legacyBucketWriter IAM 角色。如需設定身分與存取權管理權限的相關說明，請參閱「使用身分與存取權管理權限」一文。
匯出您的資料庫：

使用任何要求資料之前，請先替換以下項目：
- project-id：專案 ID
- instance-id：執行個體 ID
- bucket_name：Cloud Storage 值區名稱
- path_to_csv_file：CSV 檔案的路徑
- database_name：Cloud SQL 執行個體內的資料庫名稱
- offload：啟用無伺服器匯出功能。將其設為 true 即可使用無伺服器匯出功能。
  注意：無伺服器匯出功能需額外付費。請參閱定價頁面。
- select_query：匯出用的 SQL 查詢 (選用)
  注意：在傳輸期間，系統可能會在目標執行個體位置以外的中繼位置處理查詢。
- escape_character：應出現在需要轉義的資料字元前方的字元。這個引數的值必須是十六進制 ASCII 碼的字元。例如「22」代表雙引號。(選填)
- quote_character：用來括住字串資料類型資料欄的值的字元。這個引數的值必須是十六進制 ASCII 碼的字元。例如「22」代表雙引號。(選填)
- fields_terminated_by：用來分割資料欄值的字元。這個引數的值必須是十六進制 ASCII 碼的字元。舉例來說，「2C」代表逗號。(選填)
- lines_terminated_by：用來分割行記錄的字元。這個引數的值必須是十六進制 ASCII 碼的字元。例如「0A」代表換行。(選填)
HTTP 方法和網址：
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export
```
JSON 要求主體：
```
{
 "exportContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "databases": ["database_name"],
      "offload": true | false
      "csvExportOptions":
       {
           "selectQuery":"select_query",
           "escapeCharacter":"escape_character",
           "quoteCharacter":"quote_character",
           "fieldsTerminatedBy":"fields_terminated_by",
           "linesTerminatedBy":"lines_terminated_by"
       }
   }
}
```
如要傳送要求，請展開以下其中一個選項：
curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export"
```
PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export" | Select-Object -Expand Content
```
您應該會收到如下的 JSON 回應：
回應
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
您必須使用 databases 屬性指定單一資料庫，如果所選查詢指定了資料庫，則該資料庫必須相同。
如果您不需要保留先前設定的 IAM 權限，請立即予以移除。

如需此要求的完整參數清單，請參閱 instances:export 頁面。

REST v1beta4

建立匯出的值區：
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
這並不是必要的步驟，但我們強烈建議您這麼做，以避免開放其他資料的存取權限。
為執行個體提供值區的 storage.objectAdmin IAM 角色。如需設定身分與存取權管理權限的相關說明，請參閱「使用身分與存取權管理權限」一文。
匯出您的資料庫：

使用任何要求資料之前，請先替換以下項目：
- project-id：專案 ID
- instance-id：執行個體 ID
- bucket_name：Cloud Storage 值區名稱
- path_to_csv_file：CSV 檔案的路徑
- database_name：Cloud SQL 執行個體內的資料庫名稱
- offload：啟用無伺服器匯出功能。將其設為 true 即可使用無伺服器匯出功能。
  注意：無伺服器匯出功能需額外付費。請參閱定價頁面。
- select_query：匯出用的 SQL 查詢 (選用)
  注意：在傳輸期間，系統可能會在目標執行個體位置以外的中繼位置處理查詢。
- escape_character：應出現在需要轉義的資料字元前方的字元。這個引數的值必須採用 ASCII 十六進位格式。例如「22」代表雙引號。(選填)
- quote_character：用來括住字串資料類型資料欄的值的字元。這個引數的值必須採用 ASCII 十六進位格式。例如「22」代表雙引號。(選填)
- fields_terminated_by：用來拆分資料欄值的字元。這個引數的值必須採用 ASCII 十六進位格式。舉例來說，「2C」代表逗號。(選用)
- lines_terminated_by：用來分割行記錄的字元。這個引數的值必須採用 ASCII 十六進位格式。例如「0A」代表換行。(選用)
HTTP 方法和網址：
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export
```
JSON 要求主體：
```
{
 "exportContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "databases": ["database_name"],
      "offload": true | false
      "csvExportOptions":
       {
           "selectQuery": "select_query",
           "escapeCharacter":  "escape_character",
           "quoteCharacter": "quote_character",
           "fieldsTerminatedBy": "fields_terminated_by",
           "linesTerminatedBy": "lines_terminated_by"
       }
   }
}
```
如要傳送要求，請展開以下其中一個選項：
curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export"
```
PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export" | Select-Object -Expand Content
```
您應該會收到如下的 JSON 回應：
回應
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
您必須使用 databases 屬性指定單一資料庫，如果所選查詢指定了資料庫，則該資料庫必須相同。
如果您不需要保留先前設定的 IAM 角色，請立即撤銷。

如需此要求的完整參數清單，請參閱 instances:export 頁面。

自訂 CSV 匯出檔案的格式

您可以使用 gcloud 或 REST API 自訂 CSV 檔案格式。執行匯出作業時，您可以指定下列格式設定選項：

CSV 選項	預設值	gcloud 標記	REST API 屬性	說明
Esc 鍵	`"5C"` 檔案分隔符的 ASCII 十六進位碼。	`--escape`	`escapeCharacter`	顯示在需要轉義的資料字元前面的字元。僅適用於 MySQL 和 PostgreSQL。
引述	`"22"` 雙引號的 ASCII 十六進位碼。	`--quote`	`quoteCharacter`	用於將字串資料類型資料欄的值括起的字元。僅適用於 MySQL 和 PostgreSQL。
欄位分隔符號	`"2C"` 半形逗號的 ASCII 十六進位碼。	`--fields-terminated-by`	`fieldsTerminatedBy`	用來拆分資料欄值的字元。僅適用於 MySQL 和 PostgreSQL。
換行字元	`"0A"` 換行符號的 ASCII 十六進位碼。	`--lines-terminated-by`	`linesTerminatedBy`	用來分隔行記錄的字元。僅適用於 MySQL。

舉例來說，使用所有這些引數的 gcloud 指令可能會像以下這麼寫：

gcloud sql export csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--offload \
--query=SELECT_QUERY \
--quote="22" \
--escape="5C" \
--fields-terminated-by="2C" \
--lines-terminated-by="0A"

對等的 REST API 要求主體如下所示：

{
 "exportContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "databases": ["DATABASE_NAME"],
      "offload": true,
      "csvExportOptions":
       {
           "selectQuery": "SELECT_QUERY",
           "escapeCharacter":  "5C",
           "quoteCharacter": "22",
           "fieldsTerminatedBy": "2C",
           "linesTerminatedBy": "0A"
       }
   }
}

根據預設，CSV 匯出作業會建立標準 CSV 輸出內容。如果您需要比 Cloud SQL 提供的更多選項，可以在 psql 用戶端中使用下列陳述式：

      \copy [table_name] TO '[csv_file_name].csv' WITH
          (FORMAT csv, ESCAPE '[escape_character]', QUOTE '[quote_character]',
          DELIMITER '[delimiter_character]', ENCODING 'UTF8', NULL '[null_marker_string]');

將資料匯入 PostgreSQL 適用的 Cloud SQL

匯入至 PostgreSQL 適用的 Cloud SQL 所需的角色和權限

如要將資料從 Cloud Storage 匯入至 Cloud SQL，啟動匯入作業的使用者必須具備下列其中一個角色：

Cloud SQL 管理員角色
自訂角色，包括下列權限：
- cloudsql.instances.get
- cloudsql.instances.import

此外，Cloud SQL 執行個體的服務帳戶必須具備下列其中一個角色：

storage.objectAdmin IAM 角色
自訂角色，包括下列權限：
- storage.objects.get
- storage.objects.list (僅限平行匯入檔案)

如需有關 IAM 角色的說明，請參閱「身分與存取權管理」。

從 CSV 檔案將資料匯入 PostgreSQL 適用的 Cloud SQL

您要匯入的資料庫和資料表必須存在於 Cloud SQL 執行個體中。如需建立資料庫的說明，請參閱「建立資料庫」。
您的 CSV 檔案必須符合 CSV 檔案格式規定。

CSV 檔案格式規定

CSV 檔案的每一列資料必須有一行，並使用以半形逗號分隔的欄位。

使用 CSV 檔案將資料匯入 Cloud SQL 執行個體：

控制台

前往 Google Cloud 控制台的「Cloud SQL 執行個體」頁面。

前往 Cloud SQL 執行個體
如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
按一下「匯入」。
在「選擇匯入資料的來源檔案」部分，輸入要用來匯入的儲存桶和 CSV 檔案路徑。或瀏覽檔案：
1. 按一下「瀏覽」。
2. 在「位置」部分，按兩下清單中的值區名稱。
3. 在清單中選取檔案。
4. 按一下 [選取]。
您可以匯入壓縮 (.gz) 或未壓縮 (.csv) 的檔案。
在「格式」部分中，選取「CSV」。
在您要匯入 CSV 檔案的 Cloud SQL 執行個體中，指定「Database」(資料庫) 與「Table」(資料表)。
您可以選擇為匯入作業指定使用者。
按一下 [Import] (匯入) 即可開始匯入。

gcloud

建立 Cloud Storage 值區。
上傳檔案至值區。

如需將檔案上傳至值區的說明，請參閱上傳物件。
將 CSV 檔案中的資料上傳至值區。
找出要匯出的 Cloud SQL 執行個體的服務帳戶。您可以執行含有執行個體名稱的 gcloud sql instances describe 指令來執行此操作。在輸出內容中尋找 serviceAccountEmailAddress 欄位。
```
gcloud sql instances describe INSTANCE_NAME
```
複製「serviceAccountEmailAddress」欄位。
使用 gcloud storage buckets add-iam-policy-binding 將 storage.objectAdmin IAM 角色授予儲存桶的 Cloud SQL 執行個體服務帳戶。如需設定身分與存取權管理權限的說明，請參閱「使用身分與存取權管理權限」。

匯入檔案：

gcloud sql import csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--table=TABLE_NAME

如要瞭解如何使用 import csv 指令，請參閱 sql import csv 指令參考資料頁面。

如果您不需要保留先前設定的 IAM 權限，請使用 gcloud storage buckets remove-iam-policy-binding 將其移除。

REST v1

建立 Cloud Storage 值區。
上傳檔案至值區。

如需將檔案上傳至值區的說明，請參閱上傳物件。
為執行個體提供值區的 legacyBucketWriter 和 objectViewer IAM 角色。如需設定身分與存取權管理權限的說明，請參閱「使用身分與存取權管理權限」。

匯入檔案：

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID
bucket_name：Cloud Storage 值區名稱
path_to_csv_file：CSV 檔案的路徑
database_name：Cloud SQL 執行個體內的資料庫名稱
table_name：資料庫資料表的名稱
escape_character：應出現在需要轉義的資料字元前方的字元。這個引數的值必須是十六進制 ASCII 碼的字元。例如「22」代表雙引號。(選填)
quote_character：用來括住字串資料類型資料欄的值的字元。這個引數的值必須是十六進制 ASCII 碼的字元。例如「22」代表雙引號。(選填)
fields_terminated_by：用來分割資料欄值的字元。這個引數的值必須是十六進制 ASCII 碼的字元。舉例來說，「2C」代表逗號。(選用)
lines_terminated_by：用來分割行記錄的字元。這個引數的值必須是十六進制 ASCII 碼的字元。例如「0A」代表換行。(選用)

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import

JSON 要求主體：

{
 "importContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "database": "database_name",
      "csvImportOptions":
       {
         "table": "table_name",
         "escapeCharacter": "escape_character",
         "quoteCharacter": "quote_character",
         "fieldsTerminatedBy": "fields_terminated_by",
         "linesTerminatedBy": "lines_terminated_by"
       }
   }
}

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import"

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

如果您不需要保留先前設定的 IAM 權限，請移除權限。

REST v1beta4

建立 Cloud Storage 值區。
上傳檔案至值區。

如需將檔案上傳至值區的說明，請參閱上傳物件。
為執行個體提供值區的 storage.objectAdmin IAM 角色。如需設定身分與存取權管理權限的說明，請參閱「使用身分與存取權管理權限」一文。

匯入檔案：

使用任何要求資料之前，請先替換以下項目：

project-id：專案 ID
instance-id：執行個體 ID
bucket_name：Cloud Storage 值區名稱
path_to_csv_file：CSV 檔案的路徑
database_name：Cloud SQL 執行個體內的資料庫名稱
table_name：資料庫資料表的名稱
escape_character：應出現在需要轉義的資料字元前方的字元。這個引數的值必須採用 ASCII 十六進位格式。例如「22」代表雙引號。(選填)
quote_character：用來括住字串資料類型資料欄的值的字元。這個引數的值必須採用 ASCII 十六進位格式。例如「22」代表雙引號。(選填)
fields_terminated_by：用來分割資料欄值的字元。這個引數的值必須採用 ASCII 十六進位格式。舉例來說，「2C」代表逗號。(選用)
lines_terminated_by：用來分割行記錄的字元。這個引數的值必須採用 ASCII 十六進位格式。例如「0A」代表換行。(選用)

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import

JSON 要求主體：

{
 "importContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "database": "database_name",
      "csvImportOptions":
       {
         "table": "table_name",
         "escapeCharacter": "escape_character",
         "quoteCharacter": "quote_character",
         "fieldsTerminatedBy": "fields_terminated_by",
         "linesTerminatedBy": "lines_terminated_by"
       }
   }
}

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import"

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

回應

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

如果您不需要保留先前設定的 IAM 權限，請移除權限。

自訂 PostgreSQL 適用的 Cloud SQL 的 CSV 檔案格式

您可以使用 gcloud 或 REST API 自訂 CSV 檔案格式。

以下是 gcloud 指令的範例：

gcloud sql import csv INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME \
--table=TABLE_NAME \
--quote="22" \
--escape="5C" \
--fields-terminated-by="2C" \
--lines-terminated-by="0A"

對等的 REST API 要求主體如下所示：

{
 "importContext":
   {
      "fileType": "CSV",
      "uri": "gs://bucket_name/path_to_csv_file",
      "database": ["DATABASE_NAME"],
      "csvImportOptions":
       {
           "table": "TABLE_NAME",
           "escapeCharacter":  "5C",
           "quoteCharacter": "22",
           "fieldsTerminatedBy": "2C",
           "linesTerminatedBy": "0A"
       }
   }
}

如果您看到類似 ERROR_RDBMS 的錯誤，請確認該資料夾確實存在。如果資料表已存在，請確認您對值區擁有正確的權限。如需設定 Cloud Storage 存取權控管的相關說明，請參閱「建立及管理存取權控管清單」。

如要瞭解如何建立該工作的基礎 REST API 要求，請參閱 instances:import 頁面中的 API Explorer。

使用 CSV 檔案匯出及匯入 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

從 PostgreSQL 適用的 Cloud SQL 匯出資料

從 PostgreSQL 適用的 Cloud SQL 匯出資料時，所需的角色和權限

將資料從 PostgreSQL 適用的 Cloud SQL 匯出為 CSV 檔案

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

自訂 CSV 匯出檔案的格式

將資料匯入 PostgreSQL 適用的 Cloud SQL

匯入至 PostgreSQL 適用的 Cloud SQL 所需的角色和權限

從 CSV 檔案將資料匯入 PostgreSQL 適用的 Cloud SQL

CSV 檔案格式規定

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

自訂 PostgreSQL 適用的 Cloud SQL 的 CSV 檔案格式

後續步驟

使用 CSV 檔案匯出及匯入
透過集合功能整理內容你可以依據偏好儲存及分類內容。