建立及管理資料庫

本頁面提供在 Cloud SQL 執行個體上建立、列出及刪除 PostgreSQL 資料庫的相關資訊。

新建立的執行個體會包含 postgres 資料庫。

如要進一步瞭解 PostgreSQL 資料庫，請參閱 PostgreSQL 說明文件。

事前準備

完成此頁面上的工作之前，您必須已經：

如果您想要使用 psql 用戶端建立或管理資料庫，您必須已經：

在 Cloud SQL 執行個體上建立資料庫

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

    前往 Cloud SQL 執行個體

  2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
  3. 在 SQL 導覽選單中選取「資料庫」。
  4. 按一下 [Create database] (建立資料庫)。
  5. 在「New database」(新增資料庫) 對話方塊中，指定資料庫名稱。
  6. 點選「建立」。

gcloud

如需參考資訊，請參閱 gcloud sql databases create。

gcloud sql databases create DATABASE_NAME \
--instance=INSTANCE_NAME

Terraform

如要建立資料庫，請使用 Terraform 資源。

resource "google_sql_database" "database" {
  name     = "my-database"
  instance = google_sql_database_instance.instance.name
}

套用變更

如要在 Google Cloud 專案中套用 Terraform 設定，請完成下列各節的步驟。

準備 Cloud Shell

  1. 啟動 Cloud Shell。

  2. 設定要套用 Terraform 設定的預設 Google Cloud 專案。

    每項專案只需要執行一次這個指令，且可以在任何目錄中執行。

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    如果您在 Terraform 設定檔中設定明確值，環境變數就會遭到覆寫。

準備目錄

每個 Terraform 設定檔都必須有自己的目錄 (也稱為根模組)。

  1. 在 Cloud Shell 中建立目錄，並在該目錄中建立新檔案。檔案名稱的副檔名必須是 .tf，例如 main.tf。在本教學課程中，這個檔案稱為 main.tf。
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. 如果您正在學習教學課程，可以複製每個章節或步驟中的範例程式碼。

    將範例程式碼複製到新建立的 main.tf 中。

    視需要從 GitHub 複製程式碼。如果 Terraform 程式碼片段是端對端解決方案的一部分，建議您使用這個方法。

  3. 查看並修改範例參數，套用至您的環境。
  4. 儲存變更。
  5. 初始化 Terraform。每個目錄只需執行一次這項操作。 
    terraform init

    如要使用最新版 Google 供應商，請加入 -upgrade 選項： 

    terraform init -upgrade

套用變更

  1. 檢查設定，確認 Terraform 即將建立或更新的資源符合您的預期： 
    terraform plan

    視需要修正設定。

  2. 執行下列指令，並在提示中輸入 yes，套用 Terraform 設定： 
    terraform apply

    等待 Terraform 顯示「Apply complete!」訊息。

  3. 開啟 Google Cloud 專案即可查看結果。在 Google Cloud 控制台中，前往 UI 中的資源，確認 Terraform 已建立或更新這些資源。

刪除變更

如要刪除變更，請按照下列步驟操作：

  1. 如要停用防刪除功能，請在 Terraform 設定檔中將 deletion_protection 引數設為 false。 
    deletion_protection =  "false"
  2. 執行下列指令，並在提示中輸入 yes，套用更新的 Terraform 設定： 
    terraform apply

  1. 執行下列指令，並在提示中輸入 yes，即可移除先前透過 Terraform 設定套用的資源：

    terraform destroy

REST v1

以下要求使用 databases:insert 方法在指定執行個體上建立新資料庫。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID
  • database-name：Cloud SQL 執行個體內的資料庫名稱

HTTP 方法和網址：

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

JSON 要求主體：

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "database-name"
}

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

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

REST v1beta4

以下要求使用 databases:insert 方法在指定執行個體上建立新資料庫。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID
  • database-name：Cloud SQL 執行個體內的資料庫名稱

HTTP 方法和網址：

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

JSON 要求主體：

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "database-name"
}

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

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

psql 用戶端

如需參考資訊，請參閱 PostgreSQL 說明文件的「CREATE DATABASE」一節。

請參閱 PostgreSQL 說明文件中的下列主題，瞭解相關背景和支援的字元集值清單。

CREATE DATABASE database_name
  [[ ENCODING encoding ][ LC_COLLATE lc_collate ]];

例如：
CREATE DATABASE "example_db" WITH OWNER "example_user" ENCODING 'UTF8' LC_COLLATE = 'pl_PL.utf8' LC_CTYPE = 'pl_PL.utf8' TEMPLATE template0;

列出資料庫

如何列出執行個體上的所有資料庫：

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

    前往 Cloud SQL 執行個體

  2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
  3. 按一下左側選單中的「資料庫」。「資料庫」頁面會列出資料庫，以及其定序類型、字元集和資料庫類型。

gcloud

如需參考資訊，請參閱 gcloud sql databases list。

gcloud sql databases list \
--instance=INSTANCE_NAME

REST v1

以下要求使用 databases:list 方法列出執行個體的資料庫。

當您使用 API 列出資料庫時，會看見主控台未顯示的其他範本資料庫與系統資料庫。請注意，您無法刪除或管理系統資料庫。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases

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

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

REST v1beta4

以下要求使用 databases:list 方法列出執行個體的資料庫。

當您使用 API 列出資料庫時，會看見主控台未顯示的其他範本資料庫與系統資料庫。請注意，您無法刪除或管理系統資料庫。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases

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

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

psql 用戶端

如需參考資訊，請參閱「list」一節。

當您使用 psql 用戶端列出資料庫時，會看見主控台未顯示的其他範本資料庫與系統資料庫。請注意，您無法刪除或管理系統資料庫。

\l

刪除資料庫

如何刪除在 Cloud SQL 執行個體上的資料庫：

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

    前往 Cloud SQL 執行個體

  2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
  3. 按一下左側選單中的「資料庫」。
  4. 在資料庫清單中，找到您要刪除的資料庫並按一下垃圾桶圖示。
  5. 在「Delete database」(刪除資料庫) 對話方塊中輸入資料庫名稱，然後按一下「Delete」(刪除)。

gcloud

如需參考資訊，請參閱 gcloud sql databases delete。

gcloud sql databases delete DATABASE_NAME \
--instance=INSTANCE_NAME

REST v1

以下要求使用 databases:delete 方法刪除指定資料庫。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID
  • database-name：Cloud SQL 執行個體內的資料庫名稱

HTTP 方法和網址：

DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name

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

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

REST v1beta4

以下要求使用 databases:delete 方法刪除指定資料庫。

使用任何要求資料之前，請先修改下列項目的值：

  • project-id：專案 ID
  • instance-id：執行個體 ID
  • database-name：Cloud SQL 執行個體內的資料庫名稱

HTTP 方法和網址：

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name

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

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

psql 用戶端

如需參考資訊，請參閱 PostgreSQL 說明文件中的「DROP DATABASE」一節。

DROP DATABASE [database_name];

後續步驟

歡迎試用

如果您未曾使用過 Google Cloud，歡迎建立帳戶，親自體驗實際使用 Cloud SQL 平台的成效。新客戶還能獲得價值 $300 美元的免費抵免額，用於執行、測試及部署工作負載。

免費試用 Cloud SQL