Exportar (0) Imprimir
Expandir todo

mssql (objeto)

Actualizado: agosto de 2013

Permite el uso directo de código Transact-SQL para trabajar con tablas en Base de datos SQL.

Se puede usar en todas las variedades de scripts de servidor:

  1. scripts de operación de tabla como insert, update, read y del;

  2. scripts de programador; y

  3. API personalizadas.

El objeto mssql tiene los métodos siguientes:

  • query

  • queryRaw

  • abrir

Ejecuta una consulta, especificada por una cadena TSQL; los resultados se devuelven a la devolución de llamada success del objeto options. La consulta puede incluir parámetros si está presente el parámetro params.

mssql.query(sql, params, options)

 

Parámetro Descripción

sql

Cadena TSQL que se va a ejecutar. Los marcadores de posición ?, si están presentes, se reemplazan con el contenido de la matriz params.

params

Reemplaza los marcadores de posición ? de la cadena sql.

options

Funciones de devolución de llamada success y opcionalmente error (vea los comentarios para obtener más detalles).

Ejecuta una consulta, especificada por una cadena TSQL; los resultados se devuelven a la devolución de llamada success del objeto options. La consulta puede incluir parámetros si está presente el parámetro params. Los resultados devueltos tienen formato raw.

El formato raw es un formato JSON que consta de una sección metadata en la que se describen las columnas del conjunto de resultados, seguida de una sección rows que contiene varios elementos de fila, cada uno de los cuales tiene una entrada para cada columna del conjunto de resultados. Para obtener un ejemplo, vea Trabajar con scripts de servidor en Servicios móviles.

mssql.queryRaw(sql, params, options)

 

Parámetro Descripción

sql

Cadena TSQL que se va a ejecutar. Los marcadores de posición ?, si están presentes, se reemplazan con el contenido de la matriz params.

params

Reemplaza los marcadores de posición ? de la cadena sql.

options

Funciones de devolución de llamada success y opcionalmente error (vea los comentarios para obtener más detalles).

Abre una conexión con la Base de datos SQL de Servicios móviles. La conexión se devuelve como argumento al controlador success. Se pueden invocar entonces las funciones siguientes en el objeto connection: close, queryRaw, query, beginTransaction, commit y rollback

mssql.open(options)

 

Parámetro Descripción

options

Funciones de devolución de llamada success y opcionalmente error (vea los comentarios para obtener más detalles).

 

Sintaxis Descripción

{ success: function(results) {…..}, error: function() { … }}

La función success brinda acceso a los resultados de la operación en la Base de datos SQL. La función error es opcional.

Los tres métodos de este objeto usan el parámetro options, que consta de dos funciones de devolución de llamada: una función success y una función error opcional.

La función success toma un parámetro results: en esta función se pueden procesar los resultados de la operación de Base de datos SQL.

La función opcional error se emplea para la recuperación de errores más allá del nivel predeterminado que ya proporciona Servicios móviles de Azure.

Pueden producirse errores cuando hay pérdida de conectividad con la base de datos, un objeto no válido o una consulta incorrecta. De forma predeterminada, cuando se produce un error, los scripts de servidor registran el error y escriben un resultado de error en la respuesta. Puesto que Servicios móviles proporciona control de errores predeterminado, no es necesario que usted controle los errores que puedan producirse en el servicio.

Para invalidar el control de errores predeterminado, puede implementar un control de errores explícito si desea realizar una acción de compensación determinada o cuando desea usar el objeto global console para escribir información más detallada en el registro.

Para obtener más información, vea Trabajar con scripts de servidor en Servicios móviles.

La consulta siguiente puede formar parte de cualquier tipo de script de servidor. No tiene ningún parámetro y devuelve tres registros de la tabla statusupdate en el parámetro results de la función success.

   mssql.query('select top 3 * from statusupdates', {
      success: function(results) {
         console.log(results);
      },
      error: function(err) {
                console.log("error is: " + err);
      }
   });

En el ejemplo siguiente se implementa la autorización personalizada en un script de inserción leyendo los permisos del usuario de la solicitud de la tabla permissions. Cuando se ejecuta la consulta, el marcador de posición ? de la cadena TSQL se reemplaza con el parámetro especificado, que es el campo userID del parámetro user de entrada.

function insert(item, user, request) {
    var sql = "SELECT _id FROM permissions WHERE userId = ? AND permission = 'submit order'";
    mssql.query(sql, [user.userId], {
        success: function(results) {
            if (results.length > 0) {
                // Permission record was found. Continue normal execution. 
                request.execute();
            } else {
                console.log('User %s attempted to submit an order without permissions.', user.userId);
                request.respond(statusCodes.FORBIDDEN, 'You do not have permission to submit orders.');
            }
        },
        error: function(err) {
           console.log("error is: " + err);
        }
    });
}

Mostrar:
© 2014 Microsoft