Construir o URL de conexão - Amazon Redshift

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=false;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev?ssl=false;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=false;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev;ssl=false&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.