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](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html). 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á. # ODBC O [driver ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/tree/main) de código aberto do Amazon Timestream for fornece uma interface SQL relacional LiveAnalytics para o Timestream for LiveAnalytics para desenvolvedores e permite a conectividade a partir de ferramentas de business intelligence (BI), como Power BI Desktop e Microsoft Excel. O driver Timestream for LiveAnalytics ODBC está atualmente disponível no Windows[, macOS e Linux e](https://github.com/awslabs/amazon-timestream-odbc-driver/releases) também oferece suporte a SSO com Okta e Microsoft Azure Active Directory (AD). Para obter mais informações, consulte a documentação do driver do [Amazon Timestream LiveAnalytics para ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/index.md) sobre. GitHub **Topics** + [Configurando o Timestream para LiveAnalytics o driver ODBC](ODBC-setup.md) + [Sintaxe da string de conexão e opções para o driver ODBC](ODBC-connecting.md) + [Exemplos de cadeia de conexão para o driver Timestream for ODBC LiveAnalytics](ODBC-connecting-examples.md) + [Solução de problemas de conexão com o driver ODBC](ODBC-connecting-troubleshooting.md) # Configurando o Timestream para LiveAnalytics o driver ODBC ## Configure o acesso ao Timestream LiveAnalytics em sua conta AWS Se você ainda não configurou sua AWS conta para trabalhar com o Timestream LiveAnalytics, siga as instruções em. [Acessando o Timestream para LiveAnalytics](accessing.md) ## Instale o driver ODBC em seu sistema Baixe o instalador do driver Timestream ODBC apropriado para seu sistema a partir do [ GitHubrepositório ODBC](https://github.com/awslabs/amazon-timestream-odbc-driver/releases), e siga as instruções de instalação que se aplicam ao seu sistema:. + [Guia de instalação do Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-installation-guide.md) + [Guia de instalação do macOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-installation-guide.md) + [Guia de instalação no Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-installation-guide.md) ## Defina um nome de fonte de dados (DSN) ODBC para o driver. Siga as instruções do guia de configuração do DSN para seu sistema: + [Configuração DSN do Windows](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-dsn-configuration.md) + [Configuração DSN do MacOS](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-dsn-configuration.md) + [Configuração DSN do Linux](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-dsn-configuration.md) ## Configure seu aplicativo de business intelligence (BI) para trabalhar com o driver ODBC Aqui estão as instruções para configurar vários aplicativos comuns de BI para trabalhar com o driver ODBC: + [Configuração do Microsoft Power BI.](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-power-bi.md) + [Configuração do Microsoft Excel](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-excel.md) + [Configuração do Tableau](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/tableau.md) Para outros aplicativos # 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 AWS do 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 Timestream for service. 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 Timestream for LiveAnalytics Service Endpoint. O padrão é `us-east-1`. **Opção do provedor de credencial** + **`ProfileName`**— O nome do perfil no arquivo de AWS configuração. O padrão é `NONE`. **AWS Opções de autenticação do IAM** + **`UID`**ou **`AccessKeyId`**— O ID da chave de acesso do AWS 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 Timestream do aplicativo. LiveAnalytics Um local para encontrar o ID do aplicativo (AppId) está no `entityID` campo 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`. **AWS Opções do SDK (avançado)** + **`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 registro do AWS SDK é separado do nível de registro do driver Timestream for LiveAnalytics ODBC. 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 LiveAnalytics Timestream 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. # Exemplos de cadeia de conexão para o driver Timestream for ODBC LiveAnalytics ## Exemplo de conexão com o driver ODBC com credenciais do IAM ``` Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);SessionToken=(your session token);Region=us-east-2; ``` ## Exemplo de conexão com o driver ODBC com um perfil ``` Driver={Amazon Timestream ODBC Driver};ProfileName=(the profile name);region=us-west-2; ``` O driver tentará se conectar usando as credenciais fornecidas em ou `~/.aws/credentials`, se um arquivo for especificado na variável de ambiente `AWS_SHARED_CREDENTIALS_FILE`, usando as credenciais desse arquivo. ## Exemplo de conexão com o driver ODBC com o Okta ``` driver={Amazon Timestream ODBC Driver};auth=okta;region=us-west-2;idPHost=(your host at Okta);idPUsername=(your user name);idPPassword=(your password);OktaApplicationID=(your Okta AppId);roleARN=(your role ARN);idPARN=(your Idp ARN); ``` ## Exemplo de conexão com o driver ODBC com o Azure Active Directory (AAD) ``` driver={Amazon Timestream ODBC Driver};auth=aad;region=us-west-2;idPUsername=(your user name);idPPassword=(your password);aadApplicationID=(your AAD AppId);aadClientSecret=(your AAD client secret);aadTenant=(your AAD tenant);roleARN=(your role ARN);idPARN=(your idP ARN); ``` ## Exemplo de conexão com o driver ODBC com um endpoint especificado e um nível de registro de 2 (AVISO) ``` Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);EndpointOverride=ingest.timestream.us-west-2.amazonaws.com;Region=us-east-2;LogLevel=2; ``` # Solução de problemas de conexão com o driver ODBC **nota** Quando o nome de usuário e a senha já estão especificados no DSN, não há necessidade de especificá-los novamente quando o gerenciador do driver ODBC os solicitar. Um código de erro `01S02` com uma mensagem `Re-writing (connection string option) (have you specified it several times?` ocorre quando uma opção de cadeia de conexão é passada mais de uma vez na cadeia de conexão. Especificar uma opção mais de uma vez gera um erro. Ao fazer uma conexão com um DSN e uma cadeia de conexão, se uma opção de conexão já estiver especificada no DSN, não a especifique novamente na cadeia de conexão.