Como usar tipos de dados avançados
O Microsoft JDBC Driver para SQL Server usa os tipos de dados avançados do JDBC para converter os tipos de dados do SQL Server em um formato que possa ser compreendido pela linguagem de programação Java.
Comentários
A tabela a seguir lista os mapeamentos padrão entre o SQL Server avançado, o JDBC e os tipos de dados da linguagem de programação Java.
| Tipos de SQL Server | Tipos JDBC (java.sql.Types) | Tipos da linguagem Java |
|---|---|---|
| varbinary(max) image |
LONGVARBINARY | byte[] (default), Blob, InputStream, String |
| text varchar(max) |
LONGVARCHAR | String (default), Clob, InputStream |
| ntext nvarchar(max) |
LONGVARCHAR LONGNVARCHAR (Java SE 6.0) |
String (padrão), Clob, NClob |
| Xml | LONGVARCHAR SQLXML |
String (padrão), InputStream, Clob, byte[], Blob, SQLXML |
| Udt1 | VARBINARY | String (default), byte[], InputStream |
| sqlvariant | SQLVARIANT | Objeto |
| geometria geografia |
VARBINARY | byte[] |
1 O Microsoft JDBC Driver para SQL Server dá suporte ao envio e à recuperação de UDTs CLR como dados binários, mas não à manipulação dos metadados CLR.
As seguintes seções fornecem exemplos de como é possível usar o driver JDBC e os tipos de dados avançados.
Tipos de dados BLOB e CLOB e NCLOB
O JDBC Driver implementa todos os métodos das interfaces java.sql.Blob, java.sql.Clob e java.sql.NClob.
Observação
Os valores CLOB podem ser usados com tipos de dados de valor grande do SQL Server 2005 (9.x) (ou posterior). Especificamente, os tipos CLOB podem ser usados com os tipos de dados varchar(max) e nvarchar(max) , os tipos BLOB podem ser usados com os tipos de dados varbinary(max) e image e os tipos NCLOB podem ser usados com ntext e nvarchar(max) .
Tipos de dados de valor grande
Em versões anteriores do SQL Server, o trabalho com tipos de dados de valor grande exigia procedimentos especiais. Tipos de dados de valor grande são aqueles que excedem o tamanho de linha máximo de 8 KB. O SQL Server introduziu um especificador max para os tipos de dados varchar, nvarchar e varbinary a fim de permitir o armazenamento de valores de até 2^31 bytes. As colunas de tabela e as variáveis do Transact-SQL podem especificar os tipos de dados varchar(max), nvarchar(max) ou varbinary(max).
Os cenários primários para trabalhar com tipos de valor grande envolvem recuperá-los de um banco de dados ou adicioná-los a um banco de dados. As seções a seguir descrevem abordagens diferentes para realizar estas tarefas.
Recuperando tipos de valor grande de um banco de dados
Quando você recupera um tipo de dados de valor grande não binário, como o tipo de dados varchar(max) , de um banco de dados, uma abordagem é ler esses dados como um fluxo de caracteres. No exemplo a seguir, o método executeQuery da classe SQLServerStatement é usado para recuperar dados do banco de dados e retorná-los como um conjunto de resultados. Em seguida, o método getCharacterStream da classe SQLServerResultSet é usado para ler os dados de valor grande do conjunto de resultados.
ResultSet rs = stmt.executeQuery("SELECT TOP 1 * FROM Test1");
rs.next();
Reader reader = rs.getCharacterStream(2);
Observação
Essa mesma abordagem também pode ser usada para os tipos de dados text, ntext e nvarchar(max) .
Quando você recupera um tipo de dados de valor grande binário, como o tipo de dados varbinary(max) , de um banco de dados, há diversas abordagens que você pode adotar. A abordagem mais eficiente é ler os dados como um fluxo binário, da seguinte maneira:
ResultSet rs = stmt.executeQuery("SELECT photo FROM mypics");
rs.next();
InputStream is = rs.getBinaryStream(2);
Você também pode usar o método getBytes para ler os dados como uma matriz de bytes, da seguinte maneira:
ResultSet rs = stmt.executeQuery("SELECT photo FROM mypics");
rs.next();
byte [] b = rs.getBytes(2);
Observação
Você também pode ler os dados como um BLOB. Porém, isto é menos eficiente que os dois métodos mostrados previamente.
Adicionando tipos de valor grande a um banco de dados
Carregar dados grandes com o driver JDBC funciona bem para os casos dimensionados por memória; nos casos maiores que a memória, streaming é a opção primária. Porém, o modo mais eficiente de carregar dados grandes é pelas interfaces de fluxo.
Usar uma cadeia de caracteres ou bytes também é uma opção, da seguinte maneira:
PreparedStatement pstmt = con.prepareStatement("INSERT INTO test1 (c1_id, c2_vcmax) VALUES (?, ?)");
pstmt.setInt(1, 1);
pstmt.setString(2, htmlStr);
pstmt.executeUpdate();
Observação
Esta abordagem também pode ser usada para obter valores armazenados nas colunas text, ntext e nvarchar(max) .
Se você tiver uma biblioteca de imagem no servidor e precisar carregar arquivos de imagem binários inteiros para uma coluna varbinary(max) , o método mais eficiente com o driver JDBC será usar fluxos diretamente, da seguinte maneira:
try (PreparedStatement pstmt = con.prepareStatement("INSERT INTO test1 (Col1, Col2) VALUES(?,?)")) {
File inputFile = new File("CLOBFile20mb.jpg");
try (FileInputStream inStream = new FileInputStream(inputFile)) {
int id = 1;
pstmt.setInt(1,id);
pstmt.setBinaryStream(2, inStream);
pstmt.executeUpdate();
}
}
Observação
Usar o método CLOB ou BLOB não é uma maneira eficiente de carregar dados grandes.
Modificando tipos de valor grande em um banco de dados
Na maioria dos casos, o método recomendado para atualizar ou modificar valores grandes no banco de dados é passar parâmetros pelas classes SQLServerPreparedStatement e SQLServerCallableStatement usando comandos Transact-SQL como UPDATE, WRITE e SUBSTRING.
Se você precisar substituir a instância de uma palavra em um arquivo de texto grande, como um arquivo HTML arquivado, use um objeto Clob, da seguinte maneira:
String SQL = "SELECT * FROM test1;";
try (Statement stmt = con.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE, ResultSet.CONCUR_UPDATABLE)
ResultSet rs = stmt.executeQuery(SQL)) {
rs.next();
Clob clob = rs.getClob(2);
long pos = clob.position("dog", 1);
clob.setString(pos, "cat");
rs.updateClob(2, clob);
rs.updateRow();
}
Adicionalmente, você pode fazer todo o trabalho no servidor e só passar parâmetros para uma instrução UPDATE preparada.
Para obter mais informações sobre tipos de valor grande, consulte "Usando tipos de valor grande" nos Manuais Online do SQL Server.
Tipo de dados XML
O SQL Server fornece um tipo de dados xml que permite armazenar fragmentos e documentos XML em um banco de dados do SQL Server. O tipo de dados xml é interno no SQL Server e tem algumas semelhanças com outros tipos internos, como int e varchar. Assim como ocorre com outros tipos internos, você pode usar o tipo de dados xml como um tipo de coluna ao criar uma tabela; como um tipo de variável, de parâmetro ou de retorno de função; ou em funções CAST e CONVERT do Transact-SQL.
No driver JDBC, o tipo de dados xml pode ser mapeado como um objeto de Cadeia de Caracteres, matriz de bytes, fluxo, CLOB, BLOB ou SQLXML. Cadeia de caracteres é o padrão. A partir do JDBC Driver versão 2.0, o driver JDBC dá suporte à API do JDBC 4.0, que apresenta a interface SQLXML. A interface SQLXML define métodos para interagir com os dados XML e manipulá-los. O tipo de dados SQLXML é mapeado para o tipo de dados SQL Serverxml. Para obter mais informações sobre como ler e escrever dados XML bidirecionalmente no banco de dados relacional com o tipo de dados Java SQLXML, confira Suporte a dados XML.
A implementação do tipo de dados xml no driver JDBC fornece suporte para o seguinte:
Acesso ao XML como uma cadeia de caracteres Java UTF-16 padrão para a maioria dos cenários comuns de programação
Entrada de UTF-8 e outros XML codificados de 8 bits
Acesso ao XML como uma matriz de byte com um BOM principal quando for codificado em UTF-16 para intercâmbio com outros processadores de XML e arquivos em disco
O SQL Server exige um BOM principal para XML codificado como UTF-16. O aplicativo deve fornecer isso quando os valores de parâmetro XML são fornecidos como matrizes de bytes. O SQL Server sempre gera valores de saída XML como cadeias UTF-16 sem nenhum BOM nem uma declaração de codificação incorporada. Quando os valores XML são recuperados como byte[], BinaryStream ou Blob, um BOM UTF-16 é pré-demarcado no valor.
Para obter mais informações sobre os tipos de dados xml, confira "Tipo de dados xml" nos Manuais Online do SQL Server.
Tipo de dados definido pelo usuário
A introdução de UDTs (tipos definidos pelo usuário) no SQL Server 2005 (9.x) estende o sistema de tipos SQL, permitindo que você armazene objetos e estruturas de dados personalizadas em um banco de dados do SQL Server. Os UDTs podem conter vários tipos de dados e ter comportamentos, o que os diferencia dos tipos de dados de alias tradicionais, que consistem em um único tipo de dado do sistema no SQL Server. As UDTs são definidas por usarem qualquer uma das linguagens para as quais o CLR do Microsoft .NET Framework oferece suporte e que produzem código verificável. Isto inclui Microsoft Visual C# e Visual Basic .NET. Os dados são expostos como campos e propriedades de uma classe ou estrutura baseada no .NET Framework, e os comportamentos são definidos pelos métodos da classe ou estrutura.
No SQL Server, um UDT pode ser usado como a definição de coluna de uma tabela, como uma variável em um lote do Transact-SQL ou como um argumento de uma função do Transact-SQL ou um procedimento armazenado.
Para obter mais informações sobre tipos de dados definidos pelo usuário, confira "Usando e modificando instâncias de tipos definidos pelo usuário" nos Manuais Online do SQL Server.
Tipo de dados Sql_variant
Para obter informações sobre o tipo de dados sql_variant, confira Usar o tipo de dados Sql_variant.
Tipos de dados espaciais
Para obter informações sobre tipos de dados espaciais, confira Usar tipos de dados espaciais.