SQLResult  - AS3

Indica se foram retornados todos os dados resultantes da execução de uma instrução.

Quando uma instrução retorna uma ou mais linhas, essa propriedade indica se todas as linhas foram retornadas. Quando o método execute() de um objeto SQLStatement é chamado com um valor de argumento prefetch, somente o número específico de linhas dos dados resultantes é retornado na propriedade data do objeto SQLResult. Chamadas subsequentes de SQLStatement.next() fazem com que os dados adicionais se tornem disponíveis. Essa propriedade é usada para determinar quando os resultados finais foram retornados.

Como o número de linhas é desconhecido no momento da execução, o cursor do banco de dados deve mover-se além da última linha antes que a execução de uma instrução seja considerada concluída. Quando o método SQLStatement.execute() é chamado com um argumento prefetch, ao menos uma linha a mais do que o número total de linhas no conjunto de resultados deve ser solicitada para que a propriedade complete da ocorrência SQLResult seja true.

Elementos da API relacionados

Os dados retornados como um resultado da execução da instrução, especificamente quando uma instrução SQL SELECT é executada.

Quando uma afirmação retorna uma ou várias linhas, esta propriedade é uma matriz que contém objetos que representam as linhas de dados de resultado. Cada objeto na matriz tem nomes de propriedade que equivalem aos nomes de coluna de conjunto de dados de resultado.

Por exemplo, suponha que você realiza a seguinte instrução SQL SELECT:

     SELECT lastName, firstName
     FROM employees
     

Supondo que a tabela employees contém 10 linhas, a propriedade SQLResult.data é uma Matriz com 10 elementos. Cada elemento é um objeto com duas propriedades, lastName e firstName.

A situação é mais complexa quando você está usando a instruçãoSELECT com uma coluna de resultados complexa, como uma função agregada. Por exemplo, suponha que você realiza o seguinte SQL:

     SELECT departmentId, SUM(salary)
     FROM employees
     GROUP BY departmentId
     

Nos resultados desta afirmação, cada objeto na Matriz data tem duas propriedades denominadas departmentId e SUM(salary). No entanto, "SUM(salary)" não é um identificador válido. Se você estiver usando uma coluna computada, tal como um agregado ou outra função, especifique um pseudônimo para a coluna computada na sua instrução SQL. O pseudônimo é usado como o nome da propriedade nos objetos de dados de resultado. Por exemplo, considere esta alternativa para a afirmação anterior:

     SELECT departmentId, SUM(salary) AS salarySubtotal
     FROM employees
     GROUP BY departmentId
     

Nesta matriz da afirmação data, os objetos de resultado têm duas propriedades denominadas departmentId e salarySubtotal.

O dados a propriedade é sempre uma Matriz apesar de quantas linhas e colunas estão no conjunto de resultados. Por exemplo, a seguinte instrução SELECT resulta em uma linha e uma coluna, que é essencialmente um valor exclusivo:

     SELECT COUNT(*) AS numEmployees
     FROM employees
     

Depois de realizar a pergunta, a propriedade dados contém um objeto de Matriz com um elemento. Esse elemento é um objeto com uma propriedade única, numEmployees.

Se houver nomes de coluna duplicados nos dados de resultado, por exemplo se a instrução SELECT inclui duas colunas de id diferentes de duas tabelas diferentes, os nomes duplicados serão nomes de propriedade fornecidos segundo o valor da propriedade SQLConnection.columnNameStyle. Por padrão, o nome de cada coluna é usado como o nome da propriedade, mas se houver diversas colunas no conjunto de resultados com o mesmo nome, o formato de nome longo [table-name] _ [column-name] é usado para as colunas com os nomes idênticos. Este comportamento pode ser alterado estabelecendo a propriedade SQLConnection.columnNameStyle.

Por padrão, os objetos na Matriz dados são instâncias de Objeto. Contudo, ao definir o valor da propriedade SQLStatement.itemClass para uma classe, os elementos da Matriz data são criados como ocorrências dessa classe. Para cada coluna no conjunto de dados de resultado, a classe itemClass deve ter uma propriedade cujo nome combina exatamente com o nome de coluna.

Quando uma instrução não retorna qualquer dado, essa propriedade é null. Este é o caso se a instrução não for uma instrução SELECT, ou se for uma instruçãoSELECT que retorna 0 linhas.

Elementos da API relacionados

// Employee class definition
package
{
    public class Employee
    {
        public var name:String;
        public var ssn:String;
        public var id:uint;
        public override function toString():String
        {
            return "id: "+ id.toString() + " name: " + name + " ssn: " + ssn;
        }
    }
}


// using the Employee class as SQLStatement.itemClass
var conn:SQLConnection;
var dbStatement:SQLStatement;

function init():void
{
    conn = new SQLConnection();
    conn.addEventListener(SQLEvent.OPEN, connOpenHandler);
    
    dbStatement = new SQLStatement();
    dbStatement.sqlConnection = conn;
    dbStatement.text = "SELECT id, name, ssn FROM employees";
    dbStatement.itemClass = Employee;
    
    var dbFile:File = new File(File.separator + "employee.db");
    conn.open(dbFile);
}

function connOpenHandler(event:SQLEvent):void
{
    dbStatement.addEventListener(SQLEvent.RESULT, resultHandler);
    dbStatement.execute();
}

function resultHandler(event:SQLEvent):void
{
    var result:SQLResult = dbStatement.getResult();
    if (result != null)
    {
        var emp:Employee;
        var numRows:int = result.data.length;
        for (var i:int = 0; i < numRows; i++)
        {
            emp = result.data[i];
            trace(emp.toString());
        }
    }
}

O identificador da última linha gerada criado por uma instrução SQL INSERT.

O valor será 0 se a instrução executada não foi uma instrução INSERT.

Um identificador de linha é usado para identificar exclusivamente uma linha em uma tabela no banco de dados. Geralmente, o valor é gerado pelo banco de dados.

Para obter mais informações sobre chaves primárias e identificadores de linha gerados, consulte as seções "CREATE TABLE" e "Expressões" no apêndice "Suporte SQL em bancos de dados locais".

Elementos da API relacionados

Indica quantas linhas foram afetadas pela operação. Somente alterações que foram diretamente especificadas por uma instrução INSERT, UPDATE ou DELETE são contadas.

Alterações auxiliares provocadas por disparadores não são contadas. Use a propriedade SQLConnection.totalChanges para localizar o número total de alterações, inclusive as alterações provocadas por disparadores.

Quando a operação SQL relacionada for uma instrução DELETE, sem nenhuma cláusula WHERE (ou seja, a instrução exclui todas as linhas da tabela), a propriedade rowsAffected será sempre 0, independentemente do número de linhas excluídas. Caso seja necessário saber o número de linhas excluídas, é possível incluir a cláusula WHERE WHERE 1 = 1, caso em que todas as linhas serão excluídas e a propriedade rowsAffected refletirá precisamente o número de linhas excluídas. No entanto, dependendo o número de linhas que estão sendo excluídas, esse procedimento poderá ter um impacto negativo no desempenho da instrução.

Elementos da API relacionados

Cria uma ocorrência SQLResult. Geralmente, o código do desenvolvedor não chama o construtor SQLResult diretamente. Para recuperar uma instância SQLResult associada a uma determinada instância SQLStatement, chame o método getResult() da instância. Uma instância SQLResult também é passada como argumento para a função do manipulador resultante quando uma instância Responder é especificada para uma chamada do método execute() ou next().