快速入門:使用 Ruby 查詢 Azure SQL 資料庫或 Azure SQL 受控執行個體資料庫
適用於:Azure SQL 資料庫 Azure SQL 受控執行個體
此快速入門示範如何使用 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
本文 Transact-SQL 程式碼範例使用
AdventureWorks2022
或AdventureWorksDW2022
範例資料庫,從 Microsoft SQL Server Samples 和 Community Projects (Microsoft SQL Server 範例和社群專案)首頁即可下載。
執行程式碼
在命令提示字元中,執行下列命令:
ruby sqltest.rb
驗證是否已從您的資料庫傳回前 20 個類別/產品資料列。