Compartir a través de


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:

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