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 Azure Virtual Machines
  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
  Carga de datos	Wide World Importers 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.

• Para instalar Ruby y software relacionado para el sistema operativo, consulte Configuración del entorno de desarrollo para el desarrollo de 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.

1. Inicie sesión en Azure Portal.

2. Vaya a las páginas Bases de datos SQL o SQL Managed Instance.

3. 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 máquinas virtuales. 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 las máquinas virtuales 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

1. En el editor de texto o de código, cree un archivo denominado sqltest.rb.

2. Agregue el código siguiente: Sustituya los valores de su base de datos de Azure SQL Database por <server>, <database>, <username> y <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
   

   Los ejemplos de código de Transact-SQL de este artículo utilizan la base de datos de ejemplo AdventureWorks2022 o AdventureWorksDW2022, que se pueden descargar desde la página principal de Ejemplos y proyectos de la comunidad de Microsoft SQL Server.

Ejecución del código

1. En el símbolo del sistema, ejecute el siguiente comando:

   ruby sqltest.rb
   

2. Compruebe que se devuelven las 20 primeras filas de categoría o productos de la base de datos.

Pasos siguientes

• Diseño de la primera base de datos en Azure SQL Database
• Repositorio de Github para TinyTDS
• Informe de los problemas y realización de preguntas sobre TinyTDS
• Controlador de Ruby para SQL Server