SingleStore
您可以使用 SingleStore 連接器，對 SingleStore 資料庫執行插入、刪除、更新及讀取作業。
事前準備
使用 SingleStore 連接器前，請先完成下列工作：
- 在 Google Cloud 專案中：
- 確認已設定網路連線。如要瞭解網路模式，請參閱「網路連線」。
- 將 roles/connectors.admin IAM 角色授予設定連線器的使用者。
- 將下列 IAM 角色授予要用於連接器的服務帳戶：
roles/secretmanager.viewerroles/secretmanager.secretAccessor
服務帳戶是特殊的 Google 帳戶類型，主要用於代表需要驗證且必須取得授權才能存取 Google API 資料的非人類使用者。如果您沒有服務帳戶，請建立服務帳戶。詳情請參閱「建立服務帳戶」。
- 啟用下列服務：
secretmanager.googleapis.com(Secret Manager API)connectors.googleapis.com(Connectors API)
如要瞭解如何啟用服務，請參閱「啟用服務」。
如果專案先前未啟用這些服務或權限，系統會在設定連結器時提示您啟用。
設定連接器
連線專屬於資料來源。也就是說，如果您有多個資料來源，則必須為每個資料來源建立個別的連線。如要建立連線，請按照下列步驟操作：
- 在 Cloud 控制台中，前往「Integration Connectors」>「Connections」頁面，然後選取或建立 Google Cloud 專案。
- 按一下「+ 建立新連線」，開啟「建立連線」頁面。
- 在「位置」部分中，選擇連線位置。
- 區域：從下拉式清單中選取位置。
如需所有支援的地區清單，請參閱「位置」一文。
- 點按「下一步」。
- 區域：從下拉式清單中選取位置。
- 在「連線詳細資料」部分，完成下列步驟：
- 連接器：從可用連接器的下拉式清單中選取「SingleStore」。
- 連接器版本：從可用版本的下拉式清單中選取連接器版本。
- 在「連線名稱」欄位中，輸入連線執行個體的名稱。
連線名稱必須符合下列條件：
- 連線名稱可使用英文字母、數字或連字號。
- 字母必須為小寫。
- 連線名稱開頭須為英文字母，結尾則須為英文字母或數字。
- 連結名稱不得超過 49 個字元。
- 視需要輸入連線執行個體的「Description」(說明)。
- 或者，可啟用 Cloud Logging，然後選取記錄層級。記錄層級預設為
Error。 - 服務帳戶：選取具備必要角色的服務帳戶。
- 視需要設定「連線節點設定」：
- 節點數量下限：輸入連線節點數量下限。
- 節點數量上限：輸入連線節點數量上限。
節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多，就需要越多節點；反之，處理的交易量越少，需要的節點就越少。如要瞭解節點對連接器定價的影響，請參閱「 連線節點定價」。如未輸入任何值，系統預設會將節點下限設為 2 (提高可用性)，節點上限則設為 50。
- 資料庫：SingleStore 資料庫的名稱。
- 允許使用者變數：設為 True 時，使用者變數 (以 @ 為前置字元) 可用於 SQL 查詢。
- 字元集：供應商使用的預設用戶端字元集。例如「utf8」。
- 將零日期設為空值：是否要將全為零的日期和日期時間值設為空值。
- BrowsableSchemas：這項屬性會將回報的結構定義限制為可用結構定義的子集。例如 BrowsableSchemas=SchemaA,SchemaB,SchemaC。
- 選用：按一下「+ 新增標籤」，以鍵/值組合的形式為連線新增標籤。
- 點按「下一步」。
- 在「目的地」部分，輸入要連線的遠端主機 (後端系統) 詳細資料。
- 目的地類型：選取目的地類型。
- 如要指定目的地主機名稱或 IP 位址，請選取「主機地址」，然後在「主機 1」欄位中輸入地址。
- 如要建立私人連線，請選取「Endpoint attachment」(端點連結)，然後從「Endpoint Attachment」(端點連結) 清單中選擇所需連結。
如要建立與後端系統的公開連線，並加強安全性，建議為連線設定靜態輸出 IP 位址，然後設定防火牆規則，只允許特定靜態 IP 位址。
如要輸入其他目的地，請按一下「+新增目的地」。
- 點按「下一步」。
- 目的地類型：選取目的地類型。
-
在「Authentication」(驗證) 部分中，輸入驗證詳細資料。
- 選取「驗證類型」並輸入相關詳細資料。
SingleStore 連線支援下列驗證類型：
- 使用者名稱和密碼
- 點按「下一步」。
如要瞭解如何設定這些驗證類型，請參閱「設定驗證」。
- 選取「驗證類型」並輸入相關詳細資料。
- 檢查：檢查連線和驗證詳細資料。
- 點選「建立」。
設定驗證機制
根據要使用的驗證方式輸入詳細資料。
-
使用者名稱和密碼
- 使用者名稱：連接器的使用者名稱
- 密碼：Secret Manager 密鑰，內含與連接器相關聯的密碼。
SingleStore 設定
如要設定 SingleStore 的驗證機制，請按照下列步驟操作：
- 設定 SingleStore 帳戶
- 設定 SingleStore 資料庫和目的地詳細資料
- 設定使用者名稱和密碼驗證
設定 SingleStore 帳戶
- 申請免費試用 SingleStore 帳戶。
- 登入 SingleStore 帳戶。
你可以使用 Gmail、Microsoft 或公司電子郵件地址登入。
設定 SingleStore 資料庫和目的地詳細資料
- 登入後，前往「執行個體」或「資料庫」。
- 按一下資料庫執行個體，即可查看詳細資料。找出與 SingleStore 執行個體相關聯的資料庫名稱。
- 前往導覽選單中的「雲端」，然後按一下現有工作區。
- 在「總覽」分頁中，查看工作區和工作區中的資料庫。
- 在執行個體詳細資料中，找出與 SingleStore 資料庫執行個體相關聯的伺服器主機名稱或 IP 位址，以及通訊埠編號。
連線至這個資料庫，即可存取資料。
畫面會顯示建立新工作區或資料庫的選項。
這類資訊通常會與連線詳細資料一併提供。
如要瞭解如何建立 SingleStore 資料庫，請參閱「建立資料庫」。
設定使用者名稱和密碼驗證
- 輸入用來登入 SingleStore 執行個體的使用者名稱或郵件 ID。
- 輸入用來登入 SingleStore 執行個體的密碼。
如要瞭解 SingleStore 工作區和如何建立資料庫，請參閱 SingleStore 說明文件。
連線設定範例
本節列出建立 SingleStore 連線時設定各個欄位的範例值。
SingleStore 使用者名稱密碼連線類型
| 欄位名稱 | 詳細資料 |
|---|---|
| 位置 | europe-west1 |
| 連接器 | SingleStore |
| 連接器版本 | 1 |
| 連線名稱 | google-cloud-singlestore-conn |
| 啟用 Cloud Logging | 是 |
| 服務帳戶 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| 詳細程度 | 5 |
| 節點數量下限 | 2 |
| 節點數量上限 | 50 |
| SSL 設定 | 否 |
| 目的地 | 如果目的地位於私人網路，請建立端點連結來存取。 |
| 主機位址 | HOST_ADDRESS |
| 通訊埠 | PORT |
| 使用者名稱 | 使用者名稱 |
| 密碼 | 密碼 |
| 密鑰版本 | 1 |
SingleStore SSL 連線類型
| 欄位名稱 | 詳細資料 |
|---|---|
| 位置 | Europe-West1 |
| 連接器 | SingleStore |
| 連接器版本 | 1 |
| 連線名稱 | google-cloud-singlestore-ssl-conn |
| 啟用 Cloud Logging | 是 |
| 服務帳戶 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| 詳細程度 | 5 |
| 節點數量下限 | 2 |
| 節點數量上限 | 50 |
| SSL 設定 | 啟用 SSL |
| 不安全連線 | 信任所有憑證 |
| 用戶端憑證 | CLIENT_CERTIFICATE。 |
| Secret 版本 | 1 |
| 用戶端私密金鑰 | 選取包含 PEM 格式用戶端私密金鑰的 Secret。 |
| Secret 版本 | 1 |
| 用戶端私密金鑰通關密語 | CLIENT_PRIVATE_KEY_PASSPHRASE |
| Secret 版本 | 1 |
| 目的地 | 如果目的地位於私人網路，請建立端點連結來存取。 |
| 主機位址 | HOST_ADDRESS |
| 通訊埠 | PORT |
| 使用者名稱 | 使用者名稱 |
| 密碼 | 密碼 |
| 密鑰版本 | 1 |
實體、作業和動作
所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。
- 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。
不過，連接器可能不支援或沒有任何實體，在這種情況下，
Entities清單會是空白。 - 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在
Operations清單中列出這些不支援的作業。 - 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時
Actions清單會是空白。
系統限制
SingleStore 連接器每秒可處理 10 筆交易，每個節點也是如此，且會節流任何超出此限制的交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。
如要瞭解 Integration Connectors 適用的限制，請參閱「限制」一文。
實體作業範例
範例 - 列出實體的記錄
這個範例會列出 Users 實體的記錄。
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取Users。 - 選取「
List」作業，然後按一下「完成」。 - 在「連線器」工作的「工作輸入」部分，您可以根據需求設定 filterClause。
舉例來說，如果將篩選子句設為
employeeCode='5100' and startDate='2010-01-01 00:00:00'，系統只會列出 employeeCode 為 5100 且 startDate 為 2010-01-01 00:00:00 的記錄。
範例 - 從實體取得單一記錄
這個範例會從 Users 實體擷取記錄。
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取User。 - 選取「
Get」作業，然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入
103032。其中
103032是Users實體的主鍵值。
範例 - 從實體刪除記錄
這個範例會從 Users 實體刪除記錄。
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取Users。 - 選取「
Delete」作業，然後按一下「完成」。 - 在「連線器」工作的「工作輸入」部分，按一下「entityId」，然後在「預設值」欄位中輸入
113132。或者，如果實體具有複合式主鍵，而非指定 entityId，則可以設定 filterClause。例如：
employeeCode='5100' and startDate='2010-01-01 00:00:00'。
範例 - 在實體中建立記錄
這個範例會在 Users 實體中建立記錄。
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取Users。 - 選取「
Create」作業，然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下
connectorInputPayload，然後在Default Value欄位中輸入類似下列的值：{ "employeeCode": "5100", "startDate": "2010-01-01 00:00:00.0", "country": "US" }
如果整合成功，連接器工作的 connectorOutputPayload 欄位會顯示建立作業的回應。
範例 - 更新實體中的記錄
這個範例會更新 Users 實體中的記錄。
- 在「
Configure connector task」對話方塊中，按一下Entities。 - 從
Entity清單中選取Users。 - 選取「
Update」作業，然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下
connectorInputPayload，然後在Default Value欄位中輸入類似下列的值：{ "country": "IN" }
- 在「連線器」工作的「工作輸入」部分，按一下「entityId」，然後在「預設值」欄位中輸入
113132。或者，如果實體具有複合式主鍵，而非指定 entityId，則可以設定 filterClause。例如：
employeeCode='5100' and startDate='2010-01-01 00:00:00'。
如果整合成功，連接器工作的 connectorOutputPayload 欄位會顯示更新作業的回應。
動作
本節列出連接器支援的操作。如要瞭解如何設定動作，請參閱動作範例。
ExecuteCustomQuery 動作
這項操作可讓您執行自訂查詢。
如要建立自訂查詢，請按照下列步驟操作：
- 請按照詳細說明 新增連接器工作。
- 設定連接器工作時，請在要執行的動作類型中選取「動作」。
- 在「動作」清單中，選取「執行自訂查詢」，然後按一下「完成」。
- 展開「Task input」(工作輸入) 區段，然後執行下列操作：
- 在「Timeout after」(逾時時間) 欄位中，輸入查詢執行前的等待秒數。
預設值：
180秒。 - 在「資料列數量上限」欄位中，輸入要從資料庫傳回的資料列數量上限。
預設值為
25。 - 如要更新自訂查詢，請按一下「編輯自訂指令碼」。「指令碼編輯器」對話方塊隨即開啟。
- 在「指令碼編輯器」對話方塊中輸入 SQL 查詢，然後按一下「儲存」。
您可以在 SQL 陳述式中使用問號 (?) 代表單一參數，該參數必須在查詢參數清單中指定。舉例來說，下列 SQL 查詢會從
Employees資料表選取與LastName資料欄指定值相符的所有資料列：SELECT * FROM Employees where LastName=?
- 如果您在 SQL 查詢中使用問號，請為每個問號點按「+ 新增參數名稱」，加入參數。執行整合時，這些參數會依序取代 SQL 查詢中的問號 (?)。舉例來說，如果您新增了三個問號 (?)，就必須依序新增三個參數。
如要新增查詢參數，請按照下列步驟操作：
- 在「類型」清單中，選取參數的資料類型。
- 在「值」欄位中輸入參數值。
- 如要新增多個參數，請按一下「+ 新增查詢參數」。
- 在「Timeout after」(逾時時間) 欄位中，輸入查詢執行前的等待秒數。
執行成功後，這項動作會傳回狀態 200 (OK)，以及含有查詢結果的回應內容。
已知問題
如果實體有 Bit 和 Blob 類型的欄位，建立、讀取、更新和刪除作業就會失敗。
動作範例
範例 - 找出較大的值
這個範例說明如何執行使用者定義函式。在本範例中，find_greater 函式會比較兩個整數，並傳回較大的整數。
- 在「
Configure connector task」對話方塊中，按一下Actions。 - 選取
find_greater動作，然後按一下「完成」。 - 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下
connectorInputPayload，然後在Default Value欄位中輸入類似下列的值：{ "$1": 1.0, "$2": 5.0 }
如果動作執行成功，連接器工作的 connectorOutputPayload
欄位會包含類似以下內容的值：
[{ "bignum": 5.0 }]
使用 Terraform 建立連線
您可以使用 Terraform 資源建立新連線。
如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。
如要查看用於建立連線的 Terraform 範本範例，請參閱範本範例。
使用 Terraform 建立這項連線時，您必須在 Terraform 設定檔中設定下列變數：
| 參數名稱 | 資料類型 | 必填 | 說明 |
|---|---|---|---|
| 資料庫 | STRING | 是 | SingleStore 資料庫的名稱。 |
| allow_user_variables | BOOLEAN | 否 | 設為 True 時，使用者變數 (以 @ 為前置字串) 可用於 SQL 查詢。 |
| characterset | STRING | 否 | 供應商使用的預設用戶端字元集。例如「utf8」。 |
| zero_dates_to_null | BOOLEAN | 否 | 是否要將全為零的日期和日期時間值做為 NULL 傳回。 |
| browsable_schemas | STRING | 否 | 這項屬性會將回報的結構定義限制為可用結構定義的子集。例如 BrowsableSchemas=SchemaA,SchemaB,SchemaC。 |
在整合服務中使用 SingleStore 連線
建立連線後，Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連接器」工作使用連線。
- 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。
- 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作，請參閱「連線器工作」。