Sintaxe da string de conexão e opções para o driver ODBC - Amazon Timestream
Conexão proxy

Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais aqui.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Sintaxe da string de conexão e opções para o driver ODBC

A sintaxe para especificar as opções de cadeia de conexão para o driver ODBC é a seguinte:

DRIVER={Amazon Timestream ODBC Driver};(option)=(value);

As opções disponíveis são as seguintes:

Opções de conexão do driver

  • Driver   (obrigatório)   –   O driver que está sendo usado com o ODBC.

    O padrão é Amazon Timestream.

  • DSN   –   O nome da fonte de dados (DSN) a ser usado para configurar a conexão.

    O padrão é NONE.

  • Auth   –   Modo de autenticação. Este valor deve ser um dos seguintes:

    • AWS_PROFILE — Use a cadeia de credenciais padrão.

    • IAM – Use as credenciais do AWS IAM

    • AAD – Use o provedor de identidade do Azure Active Directory (AD).

    • OKTA – Use o provedor de identidade Okta.

    O padrão é AWS_PROFILE.

Opções de configuração do endpoint

  • EndpointOverride   –  A substituição do endpoint para o serviço Timestream para LiveAnalytics. Essa é uma opção avançada que substitui a região. Por exemplo:

    query-cell2.timestream.us-east-1.amazonaws.com

  • Region   –   A região de assinatura do endpoint do serviço Timestream para LiveAnalytics.

    O padrão é us-east-1.

Opção do provedor de credencial

  • ProfileName   –   O nome do perfil no arquivo de configuração AWS.

    O padrão é NONE.

Opções adicionais de autenticação IAM da AWS

  • UID or AccessKeyId   –   O ID da AWS de chave de acesso do usuário. Se ambos UID e AccessKeyId forem fornecidos na cadeia de conexão, o UID valor será usado, a menos que esteja vazio.

    O padrão é NONE.

  • PWD ou SecretKey   –   A chave de acesso secreta do usuário da AWS. Se ambos PWD e SecretKey forem fornecidos na string de conexão, o valor PWD será usado, a menos que esteja vazio.

    O padrão é NONE.

  • SessionToken   –   O token de sessão temporário necessário para acessar um banco de dados com a autenticação multifator (MFA) habilitada. Não inclua um = no final da entrada.

    O padrão é NONE.

Opções de autenticação baseadas em SAML para Okta

  • IdPHost   –   O nome do host do IdP especificado.

    O padrão é NONE.

  • UID ou IdPUserName   –   O nome de usuário da conta IdP especificada. Se ambos UID e IdPUserName forem fornecidos na string de conexão, o valor UID será usado, a menos que esteja vazio.

    O padrão é NONE.

  • PWD ou IdPPassword   –  A senha da conta IdP especificada. Se ambos PWD e IdPPassword forem fornecidos na string de conexão, o valor PWD será usado, a menos que esteja vazio.

    O padrão é NONE.

  • OktaApplicationID   –   O ID exclusivo fornecido pela Okta associado ao aplicativo Timestream para LiveAnalytics. Um local para encontrar o ID do aplicativo (appID) está no campo entityID fornecido nos metadados do aplicativo. Um exemplo é:

    entityID="http://www.okta.com//(IdPAppID)

    O padrão é NONE.

  • RoleARN   –  O nome do recurso da Amazon (ARN) da função que o autor da chamada deve assumir.

    O padrão é NONE.

  • IdPARN   –   O nome do recurso da Amazon (ARN) do provedor SAML do IAM que descreve o IdP.

    O padrão é NONE.

Opções de autenticação baseada em SAML para Azure Active Directory

  • UID ou IdPUserName   –   O nome de usuário da conta IdP especificada.

    O padrão é NONE.

  • PWD ou IdPPassword   –  A senha da conta IdP especificada.

    O padrão é NONE.

  • AADApplicationID   –   O ID exclusivo do aplicativo registrado no Azure AD.

    O padrão é NONE.

  • AADClientSecret   –   O segredo do cliente associado ao aplicativo registrado no Azure AD usado para autorizar a busca de tokens.

    O padrão é NONE.

  • AADTenant   –   O ID do locatário do Azure AD.

    O padrão é NONE.

  • RoleARN   –   O nome do recurso da Amazon (ARN) da função que o autor da chamada deve assumir.

    O padrão é NONE.

  • IdPARN   –   O nome do recurso da Amazon (ARN) do provedor SAML do IAM que descreve o IdP.

    O padrão é NONE.

Opções (avançadas) AWS SDK

  • RequestTimeout   –   O tempo em milissegundos em que o AWS SDK espera por uma solicitação de consulta antes de atingir o tempo limite. Qualquer valor não positivo desativa o tempo limite da solicitação.

    O padrão é 3000.

  • ConnectionTimeout   –   O tempo em milissegundos em que o AWS SDK espera que os dados sejam transferidos por uma conexão aberta antes de atingir o tempo limite. Um valor de 0 desativa o tempo limite da conexão. Esse valor deve ser não negativo.

    O padrão é 1000.

  • MaxRetryCountClient   –   O número máximo de tentativas para erros que podem ser repetidos com códigos de erro 5xx no SDK. O valor não deve ser negativo.

    O padrão é 0.

  • MaxConnections   –   O número máximo de conexões HTTP abertas simultaneamente com o serviço Timestream. O valor deve ser positivo.

    O padrão é 25.

Opções de log do driver ODBC

  • LogLevel   –   O nível de registro para registro do driver. Deve ser um dos seguintes:

    • 0   (OFF)

    • 1   (ERROR)

    • 2   (AVISO)

    • 3   (INFO.

    • 4   (DEBUG).

    O padrão é 1 (ERRO).

    Aviso: informações pessoais podem ser registradas pelo driver ao usar o modo de registro DEBUG.

  • LogOutput   –   Pasta na qual armazenar o arquivo de log.

    O padrão é:

    • Windows:%USERPROFILE%, ou se não estiver disponível, %HOMEDRIVE%%HOMEPATH%.

    • macOS e Linux:$HOME, ou se não estiver disponível, o campo do valor pw_dir de getpwuid(getuid()) retorno da função.

Opções de registro em log do SDK

O nível de log do SDK AWS é separado do nível de log do driver ODBC Timestream para LiveAnalytics. Configurar um não afeta o outro.

O nível de log do SDK é definido usando a variável TS_AWS_LOG_LEVEL de ambiente. Os valores válidos são:

  • OFF

  • ERROR

  • WARN

  • INFO

  • DEBUG

  • TRACE

  • FATAL

Se TS_AWS_LOG_LEVEL não estiver definido, o nível de log do SDK será definido como padrão, que é WARN.

Conectar-se por meio de um proxy

O driver ODBC suporta a conexão com o Amazon Timestream para LiveAnalytics por meio de um proxy. Para usar esse atributo, configure as seguintes variáveis de ambiente com base na sua configuração de proxy:

  • TS_PROXY_HOST   –   o host proxy.

  • TS_PROXY_PORT   –   o número da porta do proxy.

  • TS_PROXY_SCHEME   –   O esquema de proxy, http ou https.

  • TS_PROXY_USER   –   O nome de usuário a ser usado para a autenticação de proxy.

  • TS_PROXY_PASSWORD   –  A senha a ser usada para autenticação de proxy.

  • TS_PROXY_SSL_CERT_PATH   –  O arquivo de certificado SSL a ser usado para se conectar a um proxy HTTPS.

  • TS_PROXY_SSL_CERT_TYPE   –   O tipo do certificado SSL do cliente proxy.

  • TS_PROXY_SSL_KEY_PATH   –   O arquivo de chave privada a ser usado para se conectar a um proxy HTTPS.

  • TS_PROXY_SSL_KEY_TYPE   –  O tipo do arquivo de chave privada usado para se conectar a um proxy HTTPS.

  • TS_PROXY_SSL_KEY_PASSWORD   –   A frase secreta do arquivo de chave privada usado para se conectar a um proxy HTTPS.