Construir o URL de conexão
Use o URL de conexão para fornecer informações de conexão ao armazenamento de dados que você está acessando. A seguir está o formato da URL de conexão do driver JDBC do Amazon Redshift versão 2.1. Aqui, [Host] é o endpoint do servidor Amazon Redshift e [Port] é o número da porta Transmission Control Protocol (TCP) que o servidor usa para atender solicitações de clientes.
jdbc:redshift://[Host]:[Port]
Segue-se o formato de um URL de ligação que especifica algumas definições opcionais.
jdbc:redshift://[Host]:[Port]/[database];[Property1]=[Value]; [Property2]=[Value];
Se os valores de URL contiverem qualquer um dos seguintes caracteres reservados de URI, eles deverão ser codificados em URL:
-
;
-
+
-
{
-
}
-
[
-
]
-
&
-
=
-
?
-
um espaço vazio
Por exemplo, se o valor PWD
for password:password
, um URL de conexão que usa esse valor seria assim:
jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=password%3Apassword
Por exemplo, suponha que você queira se conectar à porta 9000 em um cluster do Amazon Redshift na região Oeste dos EUA (Norte da Califórnia) na AWS. Você também deseja acessar o banco de dados chamado dev
e autenticar a conexão usando um nome de usuário e senha do banco de dados. Nesse caso, use o URL de conexão a seguir.
jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=amazon
Você pode usar os seguintes caracteres para separar as opções de configuração do restante da string de URL:
-
;
-
?
Por exemplo, as strings de URL a seguir são equivalentes:
jdbc:redshift://my_host:5439/dev;ssl=true;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev?ssl=true;defaultRowFetchSize=100
Você pode usar os seguintes caracteres para separar as opções de configuração umas das outras na string de URL:
-
;
-
&
Por exemplo, as strings de URL a seguir são equivalentes:
jdbc:redshift://my_host:5439/dev;ssl=true;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev;ssl=true&defaultRowFetchSize=100
O exemplo de URL a seguir especifica um nível de log de 6 e o caminho para os logs.
jdbc:redshift://redshift.amazonaws.com:5439/dev;DSILogLevel=6;LogPath=/home/user/logs;
Não duplique propriedades no URL de conexão.
Para obter uma lista completa das opções de configuração que você pode especificar, consulte Opções para a configuração do driver JDBC versão 2.1.
nota
Ao se conectar, não use o endereço IP de um nó do cluster nem o endereço IP do endpoint da VPC. Sempre use o endpoint do Redshift para evitar interrupção desnecessária. A única exceção ao uso do URL do endpoint é quando você utiliza um nome de domínio personalizado. Para obter mais informações, consulte Usar nome de domínio personalizado para conexões de clientes.