objeto MSSQL
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

objeto MSSQL

 

Permite o uso de código Transact-SQL para trabalhar com tabelas no direto a Banco de Dados SQL.

Pode ser usado em todas as variedades de scripts do servidor:

  1. scripts de operação de tabela como Inserir, atualizar, ler, e /DEL;

  2. Scripts do Agendador; e

  3. APIs personalizadas.

Para obter uma discussão mais detalhada e informações, consulte o usando Transact-SQL para acessar tabelas seção trabalhar com scripts de servidor nos serviços móveis.

O mssql objeto tem os seguintes métodos:

  • consulta

  • queryRaw

  • Abrir

Executa uma consulta, especificada por uma cadeia de caracteres TSQL; os resultados são retornados para o sucesso no retorno de chamada a options objeto. A consulta pode incluir parâmetros se o params parâmetro estiver presente.

mssql.query(sql, params, options)

PARAMETER

Descrição

sql

A cadeia de caracteres TSQL para executar. O ? espaços reservados, se houver, são substituídos pelo conteúdo da params matriz.

params

Substitua o ? espaços reservados no sql cadeia de caracteres.

options

sucesso e, opcionalmente, erro funções de retorno de chamada (consulte comentários para obter detalhes).

Executa uma consulta, especificada por uma cadeia de caracteres TSQL; os resultados são retornados para o sucesso no retorno de chamada a options objeto. A consulta pode incluir parâmetros se o params parâmetro estiver presente. Os resultados retornados estão em brutos formato.

O brutos é um formato JSON que consiste em uma metadados seção que descreve as colunas do conjunto de resultados, seguido por um linhas seção que contém vários elementos de linha, cada um deles tem uma entrada para cada coluna no conjunto de resultados. Para obter um exemplo, consulte trabalhar com scripts de servidor nos serviços móveis.

mssql.queryRaw(sql, params, options)

PARAMETER

Descrição

sql

A cadeia de caracteres TSQL para executar. O ? espaços reservados, se houver, são substituídos pelo conteúdo da params matriz.

params

Substitua o ? espaços reservados no sql cadeia de caracteres.

options

sucesso e, opcionalmente, erro funções de retorno de chamada (consulte comentários para obter detalhes).

Abre uma conexão com o banco de dados do SQL de serviços móveis. A conexão é retornada como um argumento para o sucesso manipulador. Em seguida, você pode chamar as funções a seguir no connection objeto: Fechar, queryRaw, consulta, beginTransaction, confirmação, e reversão

mssql.open(options)

PARAMETER

Descrição

options

sucesso e, opcionalmente, erro funções de retorno de chamada (consulte comentários para obter detalhes).

Sintaxe

Descrição

{êxito: função {...}, erro: Function () {... }}

O sucesso função fornece acesso aos resultados da operação no banco de dados SQL. O erro função é opcional.

Todos os três métodos desse objeto usar o opções parâmetro, que consiste em duas funções de retorno de chamada: um sucesso função e um opcional erro função.

O sucesso função usa um resultados parâmetro: essa função é onde você pode processar os resultados da operação de banco de dados SQL.

Opcional erro função é usada para recuperação de erro além do nível padrão já fornecido pelos serviços móveis do Azure.

Falhas podem ocorrer quando há uma perda de conectividade com o banco de dados, um objeto inválido ou uma consulta incorreta. Por padrão quando ocorre um erro, scripts de servidor registram o erro e gravam um resultado de erro na resposta. Porque os serviços móveis fornecem o tratamento de erros padrão, você não precisa lidar com erros que podem ocorrer no serviço.

Você pode substituir o tratamento Implementando o tratamento de erro explícito se você quiser que uma determinada ação de compensação ou quando desejar usar o objeto global de console para gravar informações mais detalhadas no log de erro padrão.

Para obter mais informações, consulte trabalhar com scripts de servidor nos serviços móveis.

Exemplo

A consulta a seguir pode ser parte de qualquer variedade de script de servidor. Ele não tem parâmetros e retorna três registros do statusupdate na tabela a results parâmetro o success função.

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

Exemplo

O exemplo a seguir implementa autorização personalizada em um script de inserção lendo permissões para o usuário de solicitação do permissions tabela. Quando a consulta é executada, o espaço reservado ? no TSQL cadeia de caracteres é substituída pelo parâmetro fornecido, que é o userID campo de entrada usuário parâmetro.

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:
© 2016 Microsoft