快速入門：使用 Ruby 查詢 Azure SQL 資料庫或 Azure SQL 受控執行個體資料庫

發行項
03/14/2024

此快速入門示範如何使用 Ruby 連線至資料庫，並使用 Transact-SQL 陳述式查詢資料。

必要條件

若要完成本快速入門，您必須符合下列必要條件：

資料庫。您可以使用其中一個快速入門，建立並設定資料庫：

動作	SQL Database	SQL 受控執行個體	Azure 虛擬機器上的 SQL Server
建立	入口網站	入口網站	入口網站
	CLI	CLI
	PowerShell	PowerShell	PowerShell
設定	伺服器層級 IP 防火牆規則	VM 的連線能力
		來自內部部署的連線	連線到 SQL Server 執行個體
載入資料	每個快速入門載入的 Wide World Importers	還原 Wide World Importers	還原 Wide World Importers
		從 GitHub 的 BACPAC 檔案，還原或匯入 Adventure Works	從 GitHub 的 BACPAC 檔案，還原或匯入 Adventure Works

重要

本文中已撰寫的指令碼會使用 Adventure Works 資料庫。對於 SQL 受控執行個體，將 Adventure Works 資料庫匯入執行個體資料庫中，或將本文中的指令碼修改為使用 Wide World Importers 資料庫。

如需為作業系統安裝 Ruby 和相關軟體，請參閱設定 Ruby 開發的開發環境。

取得伺服器連線資訊

取得連線到 Azure SQL 資料庫資料庫所需的資訊。在後續程序中，您將需要完整的伺服器名稱或主機名稱、資料庫名稱和登入資訊。

登入 Azure 入口網站。
瀏覽至 [SQL Database] 或 [SQL 受控執行個體] 頁面。
在 [概觀] 頁面上，針對 Azure SQL 資料庫資料庫檢閱 [伺服器名稱] 旁的完整伺服器名稱；若為 Azure SQL 受控執行個體或虛擬機器上的 SQL Server，則檢閱 [主機] 旁的完整伺服器名稱 (或 IP 位址)。若要複製伺服器名稱或主機名稱，請將滑鼠暫留在其上方，然後選取 [複製] 圖示。

注意

如需 Azure 虛擬機器上的 SQL Server 連線資訊，請參閱連線到 SQL Server 執行個體。

建立程式碼以查詢 Azure SQL 資料庫資料庫

在文字或程式碼編輯器中，建立名為 sqltest.rb 的新檔案。

加入下列程式碼。將 Azure SQL 資料庫資料庫中的值取代為 <server>、<database>、<username> 和 <password>。

require 'tiny_tds'
server = '<server>.database.windows.net'
database = '<database>'
username = '<username>'
password = '<password>'
client = TinyTds::Client.new username: username, password: password,
    host: server, port: 1433, database: database, azure: true

puts "Reading data from table"
tsql = "SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
        FROM [SalesLT].[ProductCategory] pc
        JOIN [SalesLT].[Product] p
        ON pc.productcategoryid = p.productcategoryid"
result = client.execute(tsql)
result.each do |row|
    puts row
end

本文需要 AdventureWorks2022 範例資料庫，您可以從 [Microsoft SQL Server 範例和社群專案] 首頁下載。

執行程式碼

在命令提示字元中，執行下列命令：
```
ruby sqltest.rb
```
驗證是否已從您的資料庫傳回前 20 個類別/產品資料列。