# Text to SQL

## 什麼是 Text to SQL？

Text2SQL 功能是一項由生成式 AI 驅動的創新技術，旨在徹底改變技術人員與資料庫互動的方式。傳統上，從資料庫提取特定資訊需要具備 SQL 的專業知識並手動編寫查詢語句。Text2SQL 技術則允許使用者透過輸入日常的自然語言問句，由 AI 引擎自動將其轉換為精確的 SQL 查詢，並從您的資料庫中檢索結果。這大大降低了數據存取的門檻，使非 SQL 背景的技術人員也能輕鬆獲取所需數據，提升工作效率。

<figure><img src="https://527168072-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F38pkhhqHl1oA6yyE9R2n%2Fuploads%2FyX0oEOXpW7kzW5ToIsp4%2Fimage.png?alt=media&#x26;token=6a670c97-d296-479e-a54d-1e9c5eca376a" alt=""><figcaption></figcaption></figure>

## Text2SQL 的核心價值與重要性

在數據驅動的時代，快速且便捷地獲取數據洞察至關重要。Text2SQL 技術帶來了以下核心價值：

* **降低門檻：** 降低了數據查詢的技術門檻，使得不具備 SQL 編寫能力的業務人員、分析師甚至管理層也能直接與數據互動，獲取即時資訊。
* **提升效率：** 對於熟悉 SQL 的技術人員，Text2SQL 也能在處理常規或重複性查詢時節省大量時間，讓他們能專注於更複雜的數據分析與系統架構工作。
* **加速決策：** 即時的數據查詢能力有助於企業更快地響應市場變化，做出更明智的業務決策。
* **減少錯誤：** 自動生成的 SQL 語句可以在一定程度上減少手動編寫時可能出現的語法錯誤。

## Text2SQL 的基礎運作原理

雖然具體的實現細節可能因模型而異，但 Text2SQL 的運作通常包含以下幾個關鍵步驟：

1. 自然語言理解 (NLU)： AI 模型首先解析使用者輸入的自然語言問題，識別其中的關鍵詞、實體、意圖以及它們之間的關係。
2. Schema 連結 (Schema Linking)： 模型需要理解資料庫的結構，包括有哪些資料表 (Tables)、每個資料表有哪些欄位 (Columns)，以及它們的數據類型和可能的關聯。這一步會將問題中的詞彙對應到具體的資料表和欄位。
3. SQL 語句生成： 根據對問題意圖和資料庫結構的理解，模型會構建出符合 SQL 語法的查詢語句。這可能涉及到選擇合適的 SELECT, FROM, WHERE, GROUP BY, ORDER BY 等子句。
4. 查詢執行與結果呈現（可選）： 生成的 SQL 語句可以被直接發送到資料庫執行，並將查詢結果返回給使用者。

## MaiAgent 的 Text2SQL 功能獨特優勢

了解了 Text2SQL 的基礎知識和應用後，讓我們來看看 MaiAgent 如何為您提供強大且易用的 Text2SQL 功能。MaiAgent 致力於簡化數據存取流程，其 Text2SQL 功能具備以下核心優勢：

### **廣泛的資料庫兼容性**

MaiAgent 深知企業數據環境的多樣性，因此我們的 Text2SQL 功能**目前支援多種主流的關聯式資料庫系統**，包括：

* **MySQL**
* **PostgreSQL**
* **Oracle DB**
* **Microsoft SQL Server (MSSQL)**

這意味著無論您的數據存儲在哪種常見的資料庫中，MaiAgent 都能夠無縫對接，提供一致的自然語言查詢體驗。

### **無縫整合試算表資料**

除了傳統資料庫，MaiAgent 理解到許多臨時性或小型數據集常常以試算表的形式存在。為此，MaiAgent 提供了創新的功能：**能夠自動將試算表資料（支援 .xlsx, .xls, .csv 格式）轉換為可查詢的臨時資料庫。**

使用者只需上傳試算表檔案，MaiAgent 便會解析其結構，並允許您像查詢標準資料庫一樣，使用自然語言對其進行提問。這極大地擴展了 Text2SQL 的應用範圍，使得非結構化或半結構化數據也能快速被利用。

### **極簡設定，快速上手**

MaiAgent 的設計理念是極力簡化配置過程。要使用 Text2SQL 功能連接您的資料庫，您**只需要提供資料庫的連接網址位置** (Connection String/URL)。無需複雜的驅動安裝、環境變數設定或其他繁瑣的額外配置。

這種即插即用的特性，讓技術人員可以快速將 MaiAgent 部署到現有環境，並讓終端使用者能立即開始使用自然語言查詢。

<figure><img src="https://527168072-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F38pkhhqHl1oA6yyE9R2n%2Fuploads%2FZSedWcoa1WqANjxMnPav%2F%E6%88%AA%E5%9C%96%202025-05-09%20%E4%B8%AD%E5%8D%8812.21.49.png?alt=media&#x26;token=0b3f43c4-507d-44f7-ba1a-c0d114580741" alt=""><figcaption></figcaption></figure>

### 智能 Schema 理解

MaiAgent 的核心 AI 引擎具備強大的 Schema 理解能力。在連接到您的資料庫後，它能**自動偵測並理解資料庫中的所有資料表 (Tables) 及其欄位結構、數據類型和潛在關聯。**

這種自動化的理解免去了手動標註或配置 Schema 的麻煩，確保了 Text2SQL 功能能夠準確地將自然語言問題映射到正確的數據實體上。

### 彈性指定查詢範圍

雖然 MaiAgent 能夠自動理解整個資料庫的結構，但在某些情況下，使用者可能只關心特定的幾個資料表。MaiAgent 充分考慮到這一點，允許使用者**亦可指定搜尋的 Table。**

透過指定查詢範圍，不僅可以提高查詢的相關性和準確性（避免在不相關的表中搜尋），還能在大型資料庫中提升查詢效率，更快獲得結果。

## 結論

MaiAgent 的 Text2SQL 功能旨在賦能您的團隊，讓每個人都能輕鬆駕馭數據。憑藉其廣泛的資料庫支援、獨特的試算表整合能力、極簡的配置流程、智能的 Schema 理解以及彈性的查詢範圍設定，MaiAgent 正是您在數據探索與分析旅程中的得力助手。我們鼓勵技術人員充分利用這些特性，為您的企業釋放數據的全部潛力。
