Nesta página, descrevemos o driver JDBC do Spanner, recomendada e criada pelo Google.
O Google oferece um driver JDBC de código aberto para o Spanner. A permite que os aplicativos acessem o Spanner pelo banco de dados Java Connectivity (JDBC).
Nesta página, você encontra respostas a perguntas frequentes sobre o driver JDBC do Spanner. Para aprender a usar o driver, consulte Conecte o JDBC a um banco de dados de dialeto GoogleSQL.
Suporte às linguagens de manipulação de dados (DML) e à linguagem de definição de dados (DDL)
O driver JDBC do Spanner oferece suporte a instruções DML e DDL.
Relacionamentos pai-filho e tabela intercalada
Os relacionamentos de tabelas intercaladas são mapeados para relacionamentos de chave estrangeira no JDBC.
No Spanner, um registro na tabela filha intercalada com um pai tem
sua chave primária dependente da chave primária do registro da tabela pai associado.
O Spanner define a parte da chave primária mãe da tabela filha do respectivo
primária como a chave externa, fazendo referência à chave primária da tabela pai. Dessa forma, é possível navegar pelos relacionamentos de tabela intercalada usando as chamadas de metadados de chave externa em DatabaseMetaData. Leia mais detalhes em
Sobre esquemas.
Suporte a tipos de dados
O driver JDBC não oferece suporte ao STRUCT do Spanner
tipo de dados. Todos os outros tipos têm mapeamentos apropriados.
Compatibilidade de índice
É possível usar índices em consultas SELECT usando a sintaxe de consulta apropriada. O driver de código aberto também pode criar e modificar índices como instruções DDL. É possível acessar informações sobre índices específicos usando o método DatabaseMetaData.getIndexInfo().
Suporte a consultas parametrizadas
Esse driver é compatível com a parametrização de posicionamento.
Pools de conexões
O driver JDBC do Spanner lida com o pooling internamente monitorando todas as conexões que foram abertas, bem como as propriedades da conexão que foram usados para abrir essas conexões. Essas conexões de pool são reutilizadas, por exemplo, quando é necessária uma nova conexão que tenha as mesmas propriedades de uma conexão atual. Uma conexão é fechada automaticamente se não é usada nos últimos 60 segundos.
Se você quiser fornecer seu próprio pool, use qualquer pool de conexões JDBC padrão. Configurar o pool para usar a classe do driver
com.google.cloud.spanner.jdbc.JdbcDriver e definir um Spanner válido
URL de conexão JDBC.
Limitações
Os recursos desse driver têm limites definidos pelo sistema subjacente. Consulte a cotas e limites do Spanner.
Suporte
Consulte a página de suporte para mais as opções.
A seguir
Saiba como conectar o JDBC a um banco de dados de dialeto GoogleSQL.