# 數據庫整合

## **目的**

\
透過將一個或多個整合添加到公共或私有資料庫，您可以使用AI代理的力量安全地查詢您的資料，以啟用進階應用程式和其他功能。

### **支援**

SkyDeck AI 目前支援在 AWS 上托管的 Postgresql 數據庫和Redshift數據倉庫。支持其他數據源並不特別困難，但我們必須從某處開始。如果您有其他希望使用的數據源，請聯繫支持以優先滿足您需要的集成。

### **指示**

**以下是將您的資料庫與SkyDeck AI整合的步驟：**

1. 獲取或組合連線URL。
2. 將連線URL添加到控制中心的整合部分中。
3. 在控制中心的工具部分，將該整合分配給一個智能工具或AI代理。

### 連接URL

如果你很幸運，數據庫管理員將會為你準備好一個指向你的數據庫的標準URL。如果沒有，你將需要自己搭建一個來添加SkyDeck對你的數據庫的訪問權限。這些指導將使得這個任務相對容易。

\
\
要設置一個指向在Amazon AWS上托管的PostgreSQL或Amazon Redshift數據庫的連接URL，你需要關於你的數據庫的幾個資訊：主機、端口號、數據庫名稱、用戶名和密碼。這裡是一個逐步指導:

#### PostgreSQL 資料庫

1. **主機 (Host)**：這是您的資料庫伺服器的位址。如果是 AWS RDS PostgreSQL，應類似於 `your-db-instance-name.region-name.rds.amazonaws.com`，若是 Amazon Redshift，則應為 `your-cluster-name.region-name.redshift.amazonaws.com`。
2. **埠號 (Port Number)**：這是您的資料庫伺服器正在監聽的埠。PostgreSQL 的預設埠為 5432，Amazon Redshift 為 5439。
3. **資料庫名稱 (Database Name)**：這是您要連接的資料庫的名稱。
4. **用戶名 & 密碼 (Username & Password)**：這些是您需要用以驗證資料庫的憑證。

連接 URL 的一般格式如下：

```
protocol://username:password@host:port/database
```

這是如何創建連接 URL 的方法：

1. 從協議（protocol）開始，對於 PostgreSQL 為 'postgresql'，對於 Amazon Redshift 為 'redshift'：

   ```
    postgresql://
   ```
2. 接著，加入您的用戶名和密碼，中間以冒號隔開。如果您的用戶名或密碼包含特殊字符，您需要對其做 URL 編碼。例如，如果您的用戶名是 'user'，您的密碼是 'pass'，它會變為：

   ```
    postgresql://user:pass@
   ```
3. 然後，加入您的主機和埠號，中間以冒號分隔：

   ```
    postgresql://user:pass@your-db-instance-name.region-name.rds.amazonaws.com:5432/
   ```
4. 最後，加入您的資料庫名稱：

   ```
    postgresql://user:pass@your-db-instance-name.region-name.rds.amazonaws.com:5432/your-database-name
   ```

就完成了！您已經創建了您的連接 URL。請確保將 'user', 'pass', 'your-db-instance-name.region-name.rds.amazonaws.com', '5432' 以及 'your-database-name' 替換為您實際的資料庫詳細資料。

請記住不要與任何人分享此 URL，因為它包含您的用戶名和密碼等敏感資訊。

#### RedShift DWH

連接Redshift資料庫的URL會與前面類似，但有幾個關鍵的不同：

1. 這裡的協議將是'jdbc:redshift'，而不是'postgresql'。這是因為JDBC（Java Database Connectivity，Java資料庫連接）常被用來與Redshift資料庫進行連接。
2. Redshift的預設port是5439，而非5432。

以下是Redshift連接URL的一般格式：

```
jdbc:redshift://host:port/database
```

所以，如果你要為Redshift建立一個連接URL，它將看起來如下：

```
jdbc:redshift://user:pass@your-cluster-name.region-name.redshift.amazonaws.com:5439/your-database-name
```

請記住將'user'、'pass'、'your-cluster-name.region-name.redshift.amazonaws.com'，還有'your-database-name'替換為你實際的資料庫詳細資訊。

### 添加您的整合

將您的連接 URL 粘貼到添加整合的「憑證」部分。您可以為 postgresql 或 Redshift 數據庫選擇 PostgreSQL。您可以為整合使用任何您想要的名稱，但我們建議您選擇一些能幫助您識別特定數據庫的名稱。

<figure><img src="https://792239878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDpjOuj6vh9iG28BJUH22%2Fuploads%2Fgit-blob-840c1b54fd0c835e2e67aebe57392cd9fc743395%2FAdd%20a%20DB%20Integration%20to%20Control%20Center.png?alt=media" alt="Add a DB Integration to Control Center"><figcaption></figcaption></figure>

### 通過 SkyDeckAI 訪問您的數據

今天用戶可以使用 GenStudio 中可用的分析工具訪問您的數據庫。作為管理員，您可以在控制中心的工具部分將集成分配給分析工具。然後，您可以為該工具分配標籤，以確保只有授權的人員可以訪問該工具及其在 SkyDeck AI GenStudio 工作區中的數據庫訪問。

<figure><img src="https://792239878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDpjOuj6vh9iG28BJUH22%2Fuploads%2Fgit-blob-0fa47d142fb2e7f7a20caeec6a8f4f6756b81d2f%2FAdding%20a%20DB%20Integration%20to%20Analyst%20Bob.png?alt=media" alt="Adding a DB Integration to Analyst Bob"><figcaption><p>將數據庫集成添加到支持它的工具，以便與您組織的成員共享訪問權限。</p></figcaption></figure>

#### 安全注意事項

* 在您的資料庫中創建一個只讀用戶（角色）以用於您的 SkyDeck AI 整合。SkyDeck 不需要對您的系統進行寫入，使用權限不超過必要的憑證是最安全的。然而，該用戶應能查詢您的資料系統的結構以便理解它。
* 不要分享訪問 URL，因為它包含機密的連接信息。
* 您可以通過確保使用該資料庫的工具（例如 Analyst Bob 的副本）被分配僅對您希望擁有訪問權限的用戶相對應的標籤，來限制您組織中哪些用戶可以訪問每個資料庫。