البدء السريع: استخدم Ruby للاستعلام عن قاعدة بيانات في Azure SQL Database أو Azure SQL Managed Instance
ينطبق على: Azure SQL Database Azure SQL Managed Instance
يوضح هذا البدء السريع كيفية استخدام Ruby للاتصال بقاعدة بيانات والاستعلام عن البيانات مع عبارات Transact-SQL.
المتطلبات الأساسية
لاستكمال هذا البدء السريع، ستحتاج إلى المتطلبات الأساسية التالية:
قاعدة بيانات. يمكنك استخدام إحدى هذه البدايات السريعة لإنشاء قاعدة بيانات ثم تكوينها:
إجراء قاعدة بيانات SQL مثيل SQL المدار SQL Server على Azure VM إنشاء المدخل المدخل المدخل CLI CLI PowerShell PowerShell PowerShell تكوين قاعدة جدار حماية IP على مستوى الخادم الاتصال من جهاز ظاهري الاتصال من أماكن محلية الاتصال بمثيل SQL Server بيانات التحميل Adventure Works يتم تحميلها لكل بدء سريع استعادة Wide World Importers استعادة Wide World Importers استعادة أو استيراد Adventure Works من ملف BACPAC من GitHub استعادة أو استيراد Adventure Works من ملف BACPAC من GitHub هام
تتم كتابة البرامج النصية في هذه المقالة لاستخدام قاعدة بيانات Adventure Works. مع SQL Managed Instance، يجب عليك استيراد قاعدة بيانات Adventure Works إلى قاعدة بيانات مثيل أو تعديل البرامج النصية في هذه المقالة لاستخدام قاعدة بيانات Wide World Importers.
Ruby والبرامج ذات الصلة لنظام التشغيل:
macOS: قم بتثبيت Homebrew وrbenv وruby-build وRuby وFreeTDS وTinyTDS. راجع الخطوات 1.2 و1.3 و1.4 و1.5 و2.1 في إنشاء تطبيقات Ruby باستخدام SQL Server على macOS.
Ubuntu: قم بتثبيت المتطلبات الأساسية لـ Ruby وrbenv وruby-build وRuby وFreeTDS وTinyTDS. راجع الخطوات 1.2 و1.3 و1.4 و1.5 و2.1 في إنشاء تطبيقات Ruby باستخدام SQL Server على Ubuntu.
Windows: قم بتثبيت Ruby وRuby Devkit وTinyTDS. راجع تكوين بيئة التطوير لتطوير Ruby.
الحصول على معلومات الاتصال
احصل على معلومات الاتصال التي تحتاجها للاتصال بقاعدة بيانات في Azure SQL Database. ستحتاج إلى اسم الخادم المؤهل بالكامل أو اسم المضيف واسم قاعدة البيانات ومعلومات تسجيل الدخول للإجراءات القادمة.
تسجيل الدخول إلى مدخل Azure.
انتقل إلى SQL databases أو صفحة SQL Managed Instances.
في صفحة Overview، راجع اسم الخادم المؤهل بالكامل بجوار Server name لقاعدة بيانات في Azure SQL Database أو اسم الخادم المؤهل بالكامل (أو عنوان IP) بجوار Host لـ Azure SQL Managed Instance أو SQL Server على Azure VM. لنسخ اسم الخادم أو اسم المضيف، مرر فوقه وحدد الأيقونة Copy.
ملاحظة
للحصول على معلومات الاتصال SQL Server على Azure VM، راجع Connect to a SQL Server instance.
إنشاء تعليمات برمجية للاستعلام عن قاعدة البيانات في Azure SQL Database
في محرر نص أو تعليمة برمجية، قم بإنشاء ملف جديد يُسمى sqltest.rb.
قم بإضافة التعليمات البرمجية التالية. استبدل القيم من قاعدة البيانات في Azure SQL Database لـ
<server>
و<database>
و<username>
و<password>
.هام
تستخدم التعليمة البرمجية في هذا المثال نموذج البيانات AdventureWorksLT الذي يمكنك اختياره كمصدر عند إنشاء قاعدة البيانات. إذا كانت لدى قاعدة البيانات بيانات مختلفة، فاستخدم جداول من قاعدة البيانات في استعلام SELECT.
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
تشغيل التعليمات البرمجية
في موجه الأوامر، أدخل الأمر التالي:
ruby sqltest.rb
تحقق من إرجاع صفوف أعلى 20 فئة/منتجًا من قاعدة البيانات.