快速入門:使用 Ruby 來連線及查詢適用於 MySQL 的 Azure 資料庫中的資料
適用於: 適用於 MySQL 的 Azure 資料庫 - 單一伺服器
重要
適用於 MySQL 的 Azure 資料庫單一伺服器位於淘汰路徑上。 強烈建議您升級至適用於 MySQL 的 Azure 資料庫彈性伺服器。 如需移轉至適用於 MySQL 的 Azure 資料庫彈性伺服器的詳細資訊,請參閱適用於 MySQL 的 Azure 資料庫單一伺服器會發生什麼事?
本快速入門示範如何從 Windows、Linux 和 Mac 平台使用 Ruby 應用程式和 mysql2 Gem,連線到 Azure Database for MySQL。 它會顯示如何使用 SQL 陳述式來查詢、插入、更新和刪除資料庫中的資料。 本主題假設您已熟悉使用 Ruby 進行開發,但不熟悉適用於 MySQL 的 Azure 資料庫。
必要條件
本快速入門使用在以下任一指南中建立的資源作為起點︰
重要
確保您用於連線的 IP 位址已使用 Azure 入口網站或 Azure CLI 新增伺服器的防火牆規則
安裝 Ruby
在自己的電腦上安裝 Ruby、Gem 和 MySQL2 程式庫。
- 下載並安裝 2.3 版的 Ruby。
- 從 [開始] 功能表啟動新的命令提示 (cmd)。
- 將目錄變更為 2.3 版的 Ruby 目錄。
cd c:\Ruby23-x64\bin
- 執行
ruby -v
命令以測試 Ruby 安裝,進而查看所安裝的版本。 - 執行
gem -v
命令以測試 Gem 安裝,進而查看所安裝的版本。 - 執行
gem install mysql2
命令以使用 Gem 建置適用於 Ruby 的 Mysql2 模組。
取得連線資訊
取得連線到 Azure Database for MySQL 所需的連線資訊。 您需要完整的伺服器名稱和登入認證。
- 登入 Azure 入口網站。
- 從 Azure 入口網站的左側功能表中,按一下 [所有資源],然後搜尋您所建立的伺服器 (例如 mydemoserver)。
- 按一下伺服器名稱。
- 從伺服器的 [概觀] 面板,記下 [伺服器名稱] 和 [伺服器管理員登入名稱]。 如果您忘記密碼,您也可以從此面板重設密碼。
執行 Ruby 程式碼
- 將 Ruby 程式碼從下列區段貼到文字檔中,然後使用副檔名 .rb 來將檔案儲存到專案資料夾 (例如
C:\rubymysql\createtable.rb
或/home/username/rubymysql/createtable.rb
)。 - 若要執行程式碼,請啟動命令提示字元或 Bash 殼層。 將目錄切換到專案資料夾
cd rubymysql
- 然後,輸入後面接著檔案名稱的 Ruby 命令 (例如
ruby createtable.rb
) 以執行應用程式。 - 在 Windows 作業系統上,如果 Ruby 應用程式不在您的 path 環境變數中,則可能需要使用完整路徑來啟動節點應用程式,例如
"c:\Ruby23-x64\bin\ruby.exe" createtable.rb
連線及建立資料表
使用下列程式碼搭配 CREATE TABLE SQL 陳述式 (後面接著 INSERT INTO SQL 陳述式) 來連線和建立資料表,進而在資料表中新增資料列。
程式碼會使用 mysql2::client 類別連線到 MySQL 伺服器。 然後,其會呼叫 query()
方法來執行 DROP、CREATE TABLE 和 INSERT INTO 命令。 最後會呼叫 close()
,在終止前關閉連線。
以您自己的值取代 host
、database
、username
和 password
字串。
require 'mysql2'
begin
# Initialize connection variables.
host = String('mydemoserver.mysql.database.azure.com')
database = String('quickstartdb')
username = String('myadmin@mydemoserver')
password = String('yourpassword')
# Initialize connection object.
client = Mysql2::Client.new(:host => host, :username => username, :database => database, :password => password)
puts 'Successfully created connection to database.'
# Drop previous table of same name if one exists
client.query('DROP TABLE IF EXISTS inventory;')
puts 'Finished dropping table (if existed).'
# Drop previous table of same name if one exists.
client.query('CREATE TABLE inventory (id serial PRIMARY KEY, name VARCHAR(50), quantity INTEGER);')
puts 'Finished creating table.'
# Insert some data into table.
client.query("INSERT INTO inventory VALUES(1, 'banana', 150)")
client.query("INSERT INTO inventory VALUES(2, 'orange', 154)")
client.query("INSERT INTO inventory VALUES(3, 'apple', 100)")
puts 'Inserted 3 rows of data.'
# Error handling
rescue Exception => e
puts e.message
# Cleanup
ensure
client.close if client
puts 'Done.'
end
讀取資料
使用下列程式碼搭配 SELECT SQL 陳述式來連線和讀取資料。
程式碼會使用 mysql2::client 類別,透過 new()
方法連線到適用於 MySQL 的 Azure 資料庫。 然後它會呼叫 query()
方法來執行 SELECT 命令。 然後,其會呼叫 close()
方法,以在終止前關閉連線。
以您自己的值取代 host
、database
、username
和 password
字串。
require 'mysql2'
begin
# Initialize connection variables.
host = String('mydemoserver.mysql.database.azure.com')
database = String('quickstartdb')
username = String('myadmin@mydemoserver')
password = String('yourpassword')
# Initialize connection object.
client = Mysql2::Client.new(:host => host, :username => username, :database => database, :password => password)
puts 'Successfully created connection to database.'
# Read data
resultSet = client.query('SELECT * from inventory;')
resultSet.each do |row|
puts 'Data row = (%s, %s, %s)' % [row['id'], row['name'], row['quantity']]
end
puts 'Read ' + resultSet.count.to_s + ' row(s).'
# Error handling
rescue Exception => e
puts e.message
# Cleanup
ensure
client.close if client
puts 'Done.'
end
更新資料
使用下列程式碼搭配 UPDATE SQL 陳述式來連線和更新資料。
程式碼會使用 mysql2::client 類別 .new() 來連線到 Azure Database for MySQL。 然後會呼叫 query()
方法來執行 UPDATE 命令。 然後,其會呼叫 close()
方法,以在終止前關閉連線。
以您自己的值取代 host
、database
、username
和 password
字串。
require 'mysql2'
begin
# Initialize connection variables.
host = String('mydemoserver.mysql.database.azure.com')
database = String('quickstartdb')
username = String('myadmin@mydemoserver')
password = String('yourpassword')
# Initialize connection object.
client = Mysql2::Client.new(:host => host, :username => username, :database => database, :password => password)
puts 'Successfully created connection to database.'
# Update data
client.query('UPDATE inventory SET quantity = %d WHERE name = %s;' % [200, '\'banana\''])
puts 'Updated 1 row of data.'
# Error handling
rescue Exception => e
puts e.message
# Cleanup
ensure
client.close if client
puts 'Done.'
end
刪除資料
使用下列程式碼搭配 DELETE SQL 陳述式來連線和讀取資料。
程式碼會使用 mysql2::client 類別連線到 MySQL 伺服器、執行 DELETE 命令,然後關閉與伺服器的連線。
以您自己的值取代 host
、database
、username
和 password
字串。
require 'mysql2'
begin
# Initialize connection variables.
host = String('mydemoserver.mysql.database.azure.com')
database = String('quickstartdb')
username = String('myadmin@mydemoserver')
password = String('yourpassword')
# Initialize connection object.
client = Mysql2::Client.new(:host => host, :username => username, :database => database, :password => password)
puts 'Successfully created connection to database.'
# Delete data
resultSet = client.query('DELETE FROM inventory WHERE name = %s;' % ['\'orange\''])
puts 'Deleted 1 row.'
# Error handling
rescue Exception => e
puts e.message
# Cleanup
ensure
client.close if client
puts 'Done.'
end
清除資源
若要清除在此快速入門期間使用的所有資源,請使用下列命令刪除資源群組:
az group delete \
--name $AZ_RESOURCE_GROUP \
--yes
下一步
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應