Suporte ao tipo de dados

As classes de armazenamento representam os tipos de dados reais usados para armazenar valores em um banco de dados. As seguintes classes de armazenamento săo usadas pelo banco de dados:

NULL

O valor é um valor NULL.

INTEGER

O valor é um inteiro assinado.

REAL

O valor é um número de ponto flutuante.

TEXT

O valor é uma string de texto (limitada a 256 MB).

BLOB

O valor é um BLOB (objeto binário grande); em outras palavras, dados binários brutos (limitados a 256 MB).

Todos os valores fornecidos ao banco de dados como literais incorporados em uma instruçăo SQL ou valores associados usando parâmetros a uma instruçăo SQL preparada săo atribuídos a uma classe de armazenamento antes da execuçăo da instruçăo SQL.

Os literais que fazem parte de uma instruçăo SQL săo atribuídos ŕ classe de armazenamento TEXT, caso estejam entre aspas simples ou duplas, INTEGER caso o literal seja especificado como um número sem aspas e casa decimal ou expoente, REAL caso o literal seja um número sem aspas com casa decimal ou expoente e NULL caso o valor seja NULL. Os literais com um BLOB da classe de armazenamento săo especificados usando a notaçăo X'ABCD'. Para obter mais informações, consulte Valores literais em expressões.

Valores fornecidos como parâmetros usando a matriz associativa SQLStatement.parameters săo atribuídos ŕ classe de armazenamento que mais corresponda ao tipo de dados nativos associado. Por exemplo, os valores int săo associados como uma classe de armazenamento INTEGER, os valores Number recebem a classe de armazenamento REAL, os valores String recebem a classe de armazenamento TEXT e os objetos ByteArray recebem a classe de armazenamento BLOB.

A afinidade de uma coluna é o tipo recomendado para dados armazenados nessa coluna. Quando um valor é armazenado em uma coluna (por meio de uma instruçăo INSERT ou UPDATE), o tempo de execuçăo tenta converter esse valor do tipo de dados na afinidade especificada. Por exemplo, caso um valor Date (uma ocorręncia de Date em ActionScript ou JavaScript) seja inserido em uma coluna cuja afinidade é TEXT, o valor Date é convertido na representaçăo String (equivalente ŕ chamada do método toString() do objeto) antes do armazenamento no banco de dados. Caso o valor năo possa ser convertido na afinidade especificada, ocorre um erro e a operaçăo năo é realizada. Quando um valor é recuperado do banco de dados usando uma instruçăo SELECT, ele é retornado como uma instância da classe correspondente ŕ afinidade, independentemente de ser convertido de um tipo de dados diferente quando armazenado.

Caso uma coluna aceite valores NULL, o valor ActionScript ou JavaScript null pode ser usado como um valor de parâmetro para armazenar NULL na coluna. Quando um valor da classe de armazenamento NULL é recuperado em uma instruçăo SELECT, ele sempre é retornado como o valor de ActionScript ou JavaScript null, independentemente da afinidade da coluna. Caso uma coluna aceite valores NULL, sempre verifique valores recuperados da coluna para determinar se eles săo null antes de tentar projetar os valores como um tipo que năo possa ser nulo (como, por exemplo, Number ou Boolean).

Cada coluna do banco de dados é atribuída a uma das seguintes afinidades de tipo:

TEXT (ou String)

Uma coluna com afinidade TEXT ou String armazena todos os dados que usam classes de armazenamento NULL, TEXT ou BLOB. Caso sejam inseridos dados numéricos em uma coluna com afinidade TEXT, eles săo convertidos em forma de texto antes de serem armazenados.

NUMERIC

Uma coluna com afinidade NUMERIC contém valores que usam classes de armazenamento NULL, REAL ou INTEGER. Quando dados de texto săo inseridos em uma coluna NUMERIC, é feita uma tentativa de convertę-los em um inteiro ou número real antes de serem armazenados. Caso haja ęxito na conversăo, o valor é armazenado usando a classe de armazenamento INTEGER ou REAL (por exemplo, um valor igual a '10.05' é convertido na classe de armazenamento REAL antes de ser armazenado). Caso a conversăo năo possa ser realizada, ocorre um erro. Năo é feita nenhuma tentativa de converter um valor NULL. Um valor recuperado de uma coluna NUMERIC é retornado como uma ocorręncia do tipo numérico mais específico no qual o valor se encaixa. Em outras palavras, caso o valor seja um inteiro positivo ou 0, ele é retornado como uma ocorręncia de unit. Caso seja um inteiro negativo, ele é retornado como uma ocorrência de int. Por fim, caso tenha um componente de ponto flutuante (não um inteiro), ele é retornado como uma ocorrência de Number.

INTEGER (ou int)

Uma coluna que usa afinidade INTEGER se comporta da mesma forma que uma coluna com afinidade NUMERIC, exceto por uma coisa. Caso o valor a ser armazenado seja um valor real (como, por exemplo, uma ocorręncia de Number) sem nenhum componente de ponto flutuante ou caso o valor seja um valor de texto que possa ser convertido em um valor real sem nenhum componente de ponto flutuante, ele é convertido em um inteiro e armazenado usando a classe de armazenamento INTEGER. Caso seja feita uma tentativa de armazenar um valor real com um componente de ponto flutuante, ocorre um erro.

REAL (ou Number)

Uma coluna com afinidade REAL ou NUMBER se comporta como uma coluna com afinidade NUMERIC, exceto pelo fato de forçar valores inteiros na representaçăo de ponto flutuante. Um valor em uma coluna REAL é sempre retornado do banco de dados como uma ocorręncia de Number.

Booleano

Uma coluna com afinidade Boolean armazena valores true ou false. Uma coluna Boolean aceita um valor que é uma ocorręncia de Boolean em ActionScript ou JavaScript. Caso o código tente armazenar um valor String, String com comprimento maior que zero é considerada verdadeira e uma String vazia, falsa. Caso o código tente armazenar dados numéricos, qualquer valor que năo seja zero é armazenado como true e 0, como false. Quando um valor Boolean é recuperado usando uma instruçăo SELECT, ele é retornado como uma ocorręncia de Boolean. Valores que năo sejam NULL săo armazenados usando a classe de armazenamento INTEGER (0 para false e 1 para true), sendo convertidos em objetos Boolean quando os dados săo recuperados.

Date

Uma coluna com afinidade Date armazena valores de data e hora. Uma coluna Date é projetada para aceitar valores que sejam ocorręncias de Date em ActionScript ou JavaScript. Caso seja feita uma tentativa de armazenar um valor String em uma coluna Date, o tempo de execuçăo tenta convertę-lo em uma data do calendário Juliano. Em caso de falha na conversăo, ocorre um erro. Caso o código tente armazenar um valor de Number, int ou uint, năo é feita nenhuma tentativa de validar os dados, pressupondo que ele seja um valor de data do calendário Juliano válido. Um valor Date recuperado usando uma instruçăo SELECT é convertido automaticamente em uma ocorręncia de Date. Como os valores de Date săo armazenados como valores de data do calendário Juliano usando a classe de armazenamento REAL, as operaçőes de classificaçăo e comparaçăo funcionam da forma como vocę espera.

XML ou XMLList

Uma coluna que usa afinidade XML ou XMLList armazena estruturas XML. Quando o código tenta armazenar dados em uma coluna XML usando um parâmetro SQLStatement, o tempo de execuçăo tenta converter e validar o valor usando a funçăo XML() ou XMLList() em ActionScript. Caso o valor năo possa ser convertido em um XML válido, ocorre um erro. Caso a tentativa de armazenar os dados use um valor de texto SQL literal (por exemplo, INSERT INTO (col1) VALUES ('Invalid XML (no closing tag)'), o valor não é analisado ou validado — pressupõe-se que esteja bem-formado. Caso um valor inválido seja armazenado, quando recuperado, ele é retornado como um objeto XML vazio. Dados XML e XMLList săo armazenados usando a classe de armazenamento TEXT ou NULL.

Objeto

Uma coluna com afinidade Object armazena objetos complexos em ActionScript ou JavaScript, inclusive ocorręncias da classe Object, bem como ocorręncias das subclasses de Object como, por exemplo, ocorręncias de Array e até mesmo ocorręncias de classe personalizada. Os dados da coluna Object săo serializados no formato AMF3 e armazenados usando a classe de armazenamento BLOB. Quando recuperado, um valor é desserializado do AMF3 e retornado como uma instância da classe como foi armazenado. Observe que algumas classes ActionScript, mais notadamente objetos de exibiçăo, năo podem ser desserializadas como ocorręncias do tipo de dados original. Antes de armazenar uma ocorręncia de classe personalizada, vocę deve registrar um alias para a classe usando o método flash.net.registerClassAlias() (ou em Flex, adicionando metadados [RemoteObject] ŕ declaraçăo da classe). Além disso, antes de recuperar esses dados, vocę deve registrar o mesmo alias para a classe. Qualquer dado que năo possa ser serializado corretamente porque a classe năo pode ser desserializada inerentemente ou por conta de um alias de classe ausente ou năo correspondente é retornado como um objeto anônimo (uma ocorręncia de classe Object) com propriedades e valores correspondentes ŕ ocorręncia original de acordo com o armazenamento.

NONE

Uma coluna com afinidade NONE năo prefere nenhuma classe de armazenamento em detrimento de outra. Ela năo faz nenhuma tentativa de converter dados antes de serem inseridos.

Há suporte para estes operadores de comparação binária =, <, <=, >= e !=, além de uma operação para testar a associação do conjunto, IN e operador de comparação ternário BETWEEN. Para obter detalhes sobre esses operadores, consulte Operadores.

Os resultados de uma comparaçăo dependem das classes de armazenamento dos dois valores que estăo sendo comparados. Durante a comparaçăo entre duas regras, se aplicam as seguintes regras:

• Um valor com classe de armazenamento NULL é considerado inferior a qualquer outro valor (inclusive outro valor com classe de armazenamento NULL).

• Um valor INTEGER ou REAL é inferior a qualquer valor TEXT ou BLOB. Quando INTEGER ou REAL é comparado com outro INTEGER ou REAL, é realizada uma comparaçăo numérica.

• Um valor TEXT é inferior a um valor BLOB. Quando dois valores TEXT săo comparados, é realizada uma comparaçăo binária.

• Quando dois valores BLOB săo comparados, o resultado é sempre determinado usando uma comparaçăo binária.

O operador ternário BETWEEN é sempre reprojetado como a expressăo binária equivalente. Por exemplo, a BETWEEN b AND c é reprojetado como a >= b AND a <= c, mesmo que isso signifique a aplicaçăo de afinidades diferentes a a em cada uma das comparaçőes necessárias ŕ avaliaçăo da expressăo.

Expressões do tipo a IN (SELECT b ....) são tratadas pelas três regras enumeradas anteriormente para as comparações binárias, ou seja, de maneira semelhante a a = b. Por exemplo, caso b seja um valor de coluna e a seja uma expressão, a afinidade b é aplicada a a antes da realização de qualquer outra comparação. A expressăo a IN (x, y, z) é reprojetada como a = +x OR a = +y OR a = +z. Os valores ŕ direita do operador IN (os valores x, y e z nesse exemplo) săo considerados expressőes, mesmo que sejam valores de coluna. Caso o valor ŕ esquerda do operador IN seja uma coluna, é usada a afinidade dessa coluna. Caso o valor seja uma expressăo, năo ocorre nenhuma conversăo.

A forma como as comparaçőes săo realizadas também pode ser afetada pelo uso de uma cláusula COLLATE. Para obter mais informações, consulte COLLATE.

Para cada um dos operadores matemáticos para os quais há suporte, *, /, %, + e -, a afinidade numérica é aplicada a cada operando antes da avaliaçăo da expressăo. Caso nenhum operando possa ser convertido na classe de armazenamento NUMERIC com ęxito, a expressăo é avaliada como NULL.

Quando o operador de concatenaçăo || é usado, cada operando é convertido na classe de armazenamento TEXT antes da avaliaçăo da expressăo. Caso nenhum operando possa ser convertido na classe de armazenamento TEXT, o resultado da expressăo é NULL. A impossibilidade de conversăo do valor pode acontecer em duas situaçőes: caso o valor do operando seja NULL ou caso ele seja um BLOB que contenha uma classe de armazenamento que năo seja TEXT.

Quando os valores săo classificados por uma cláusula ORDER BY, os valores com uma classe de armazenamento NULL vęm primeiro. Eles săo seguidos dos valores INTEGER e REAL dispostos em ordem numérica, seguidos dos valores TEXT em ordem binária ou com base na intercalaçăo especificada (BINARY ou NOCASE). Por fim, vęm os valores BLOB na ordem binária. Năo ocorre nenhuma conversăo de classe antes da classificaçăo.�

Durante o agrupamento de valores com a cláusula GROUP BY, valores com classes de armazenamento diferentes săo consideradas distintas. Uma exceçăo a isso săo os valores INTEGER e REAL, que săo considerados iguais caso sejam numericamente equivalentes. Nenhuma afinidade é aplicada a nenhum valor por conta de uma cláusula GROUP BY.

Os operadores SELECT compostos UNION, INTERSECT e EXCEPT realizam comparaçőes implícitas entre valores. Para que essas comparaçőes sejam realizadas, uma afinidade pode ser aplicada a cada valor. A mesma afinidade, caso haja alguma, é aplicada a todos os valores que podem ser retornados em uma única coluna do conjunto de resultados SELECT. A afinidade aplicada é a afinidade da coluna retornada pela instruçăo SELECT do primeiro componente que apresenta um valor de coluna (e năo outro tipo de expressăo) nessa posiçăo. Se, para uma determinada coluna SELECT composta, nenhuma das instruçőes SELECT do componente retornem um valor de coluna, nenhuma afinidade será aplicada aos valores dessa coluna antes de serem comparados.