# 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.

- Segurança do cliente da rede
  O cliente da rede do Derby permite selecionar o mecanismo de segurança, especificando o valor da propriedade securityMechanism.
- Rastreamento do cliente da rede
  O cliente da rede do Derby fornece facilidade de rastreamento, para coletar informações de rastreamento do JDBC e ver os fluxos do protocolo.
- Exemplos de driver cliente da rede
- Acesso ao Network Server utilizando o Universal Driver do DB2

Tópico pai: Utilização do Network Server com aplicativos Derby pré-existentes
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