Inicio rápido: Uso de Ruby para consultar una base de datos de Azure SQL Database o Instancia administrada de Azure SQL
SE APLICA A:
Azure SQL Database
Azure SQL Managed Instance
En este inicio rápido se muestra cómo se usa Ruby para conectarse a una base de datos y consultar datos con instrucciones Transact-SQL.
Requisitos previos
Para completar este tutorial de inicio rápido, debe cumplir los siguientes requisitos previos:
Una base de datos. Puede utilizar uno de estos inicios rápidos para crear y configurar la base de datos:
Acción SQL Database Instancia administrada de SQL SQL Server en máquina virtual de Azure Crear Portal Portal Portal CLI CLI PowerShell PowerShell PowerShell Configuración Regla de firewall de IP en el nivel de servidor Conectividad desde una máquina virtual Conectividad desde un entorno local Conexión a una instancia de SQL Server Cargar datos Adventure Works cargado por inicio rápido Restauración de World Wide Importers Restauración de World Wide Importers Restauración o importación de Adventure Works desde un archivo BACPAC desde GitHub Restauración o importación de Adventure Works desde un archivo BACPAC desde GitHub Importante
Los scripts de este artículo se escriben para utilizar la base de datos Adventure Works. Con una instancia administrada de SQL, debe importar la base de datos Adventure Works en una base de datos de instancia, o bien modificar los scripts de este artículo para utilizar la base de datos Wide World Importers.
Ruby y el software relacionado para el sistema operativo:
macOS: instale Homebrew, rbenv y ruby-build, Ruby, FreeTDS y TinyTDS. Consulte los pasos 1.2, 1.3, 1.4, 1.5 y 2.1 del artículo sobre la creación de aplicaciones de Ruby con SQL Server en macOS.
Ubuntu: instale los requisitos previos de Ruby, rbenv y ruby-build, Ruby, FreeTDS y TinyTDS. Consulte los pasos 1.2, 1.3, 1.4, 1.5 y 2.1 en Create Ruby apps using SQL Server on Ubuntu (Creación de aplicaciones de Ruby con SQL Server en Ubuntu).
Windows: instale Ruby, Ruby Devkit y TinyTDS. Consulte Configurar el entorno de desarrollo para el desarrollo Ruby.
Obtención de información de conexión del servidor
Obtenga la información de conexión necesaria para conectarse a una base de datos de Azure SQL Database. En los procedimientos siguientes, necesitará el nombre completo del servidor o nombre de host, el nombre de la base de datos y la información de inicio de sesión.
Inicie sesión en Azure Portal.
Vaya a las páginas Bases de datos SQL o Instancias administradas de SQL.
En la página Información general, revise el nombre completo del servidor junto a Nombre del servidor para una base de datos de Azure SQL Database o el nombre completo (o la dirección IP) del servidor junto a Host para una instancia administrada de Azure SQL o SQL Server en la máquina virtual de Azure. Para copiar el nombre del servidor o nombre de host, mantenga el cursor sobre él y seleccione el icono Copiar.
Nota
Para obtener información de la conexión de SQL Server en una máquina virtual de Azure, consulte Conexión a una instancia de SQL Server.
Creación de código para consultar una base de datos en Azure SQL Database
En el editor de texto o de código, cree un archivo denominado sqltest.rb.
Agregue el código siguiente: Sustituya los valores de su base de datos de Azure SQL Database por
<server>,<database>,<username>y<password>.Importante
El código de este ejemplo usa los datos de AdventureWorksLT de ejemplo, que puede elegir como origen al crear la base de datos. Si la base de datos tiene datos distintos, use las tablas de su propia base de datos en la consulta 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
Ejecución del código
En el símbolo del sistema, ejecute el siguiente comando:
ruby sqltest.rbCompruebe que se devuelven las 20 primeras filas de categoría o productos de la base de datos.