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 Instancias administradas de SQL.

  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 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

  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>.

    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

  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