Acesso ao Network Server utilizando o driver cliente da rede

Para se conectar ao Network Server, o aplicativo precisa carregar o driver e a URL de conexão específica para o Network Server. Além disso, caso esteja sendo utilizado autenticação, deverá ser especificado nome de usuário e senha.

O driver necessário para acessar o Network Server é:
org.apache.derby.jdbc.ClientDriver
A sintaxe da URL requerida para acessar o Network Server é:
jdbc:derby://<servidor>[:<porta>]/
<nome-do-banco-de-dados>[;<atributo-da-URL>=<valor> [;...]]
onde <atributo-da-UR> é um atributo de cliente incorporado ou da rede do Derby.
Tabela 1. Propriedades de DataSource de JDBC padrão
Propriedade Tipo Descrição Atributo da URL Notas
databaseName String O nome do banco de dados. Esta propriedade é requerida.   Esta propriedade também está disponível quando se usa EmbeddedDataSource.
dataSourceName String O nome da fonte de dados.   Esta propriedade também está disponível quando se usa EmbeddedDataSource.
description String A descrição da fonte de dados.   Esta propriedade também está disponível quando se usa EmbeddedDataSource.
user String O nome da conta do usuário. user O valor padrão é APP. Esta propriedade também está disponível quando se usa EmbeddedDataSource.
password String A senha de banco de dados do usuário. password Esta propriedade também está disponível quando se usa EmbeddedDataSource.
serverName String O nome do hospedeiro, ou o endereço de TCP/IP, onde o servidor está escutando as requisições.   O valor padrão é "localhost".
portNumber Integer O número da porta onde o servidor está escutando as requisições.   O valor padrão é "1527".
Tabela 2. Propriedades de DataSource específicas do cliente
Propriedade Tipo Descrição Atributo da URL Notas
traceFile String O nome do arquivo para saída do rastreamento. Definir esta propriedade ativa o rastreamento. Consulte Rastreamento do cliente da rede. traceFile  
traceDirectory String O diretório para saída do rastreamento. Cada conexão envia a saída para um arquivo separado. Definir esta propriedade ativa o rastreamento. Consulte Rastreamento do cliente da rede. traceDirectory  
traceLevel Integer O nível de rastreamento do cliente, se traceFile ou traceDirectory estiver definido. traceLevel O valor padrão é TRACE_ALL.
traceFileAppend Boolean Verdade se a saída do rastreamento deverá ser anexada ao arquivo de rastreamento existente. traceFileAppend O valor padrão é falso.
securityMechanism Integer O mecanismo de segurança. Consulte Segurança do cliente da rede. securityMechanism O valor padrão é USER_ONLY _SECURITY.
retrieveMessageText Boolean Buscar o texto da mensagem no servidor. É chamado um procedimento armazenado para buscar o texto da mensagem a cada SQLException, devendo iniciar uma nova unidade de trabalho. Esta propriedade deverá ser definida como falsa se não for desejado impacto no desempenho, ou quando iniciando novas unidades de trabalho. retrieveMessageText O valor padrão é verdade.
Tabela 3. Propriedades de DataSource específicas do servidor
Propriedade Tipo Descrição Atributos da URL Notas
connectionAttributes String Definido pela lista de atributos da conexão incorporada do Derby, separados por ponto-e-vírgula. Vários Esta propriedade também está disponível quando se usa EmbeddedDataSource. Para obter mais informações sobre os vários atributos de conexão, deve ser consultado o Manual de Referência do Derby.

Deve ser observado que setAttributesAsPassword, disponível para o DataSource incorporado, não está disponível para o DataSource cliente.

Conceitos relacionados
O Network Server e as JVMs
Acesso ao Network Server utilizando DataSource
XA e o Network Server
Utilização das ferramentas do Derby com o Network Server
Diferenças entre executar o Derby no modo incorporado e utilizando o Network Server
Tarefas relacionadas
Instalação dos arquivos jar requeridos e adições ao caminho de classes
Inicialização do Network Server
Parar o Network Server
Obtenção de informações do sistema
Definição do número da porta