Conexão ao Amazon DynamoDB (v.1)

O Amazon DynamoDB é um serviço de dados na nuvem. Você pode usar o conector de dados do Amazon DynamoDB para importar dados da sua organização residentes no DynamoDB.

Antes de começar

Para conectar-se ao DynamoDB, você deve obter:

• a região de hospedagem para seus serviços da Amazon Web Services
• a chave de acesso à sua conta da AWS

• a chave secreta da sua conta da AWS

Para obter ajuda na coleta dos pré-requisitos de conexão, entre em contato com o DynamoDB administrador do na sua organização. Se o administrador não conseguir ajudá-lo, você ou o administrador deve entrar em contato com o suporte da DynamoDB.

Criar uma conexão ao DynamoDB

1. No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
2. Na guia novas conexões, na seção Conectores do ACL, selecione DynamoDB.

   Dica

   Você pode filtrar a lista de conectores disponíveis inserindo uma cadeia de pesquisa na caixa Filtrar conexões. Os conectores são listados em ordem alfabética.

3. No painel Configurações de Conexão de Dados, insira as configurações da conexão e clique em Salvar e conectar na parte inferior do painel.

   Você pode aceitar o Nome de conexão padrão ou inserir um novo nome.

A conexão do DynamoDB é salva na guia Conexões existentes. No futuro, você poderá reconectar o DynamoDB usando a conexão salva.

Após estabelecer a conexão, a janela Acesso a Dados abre na Área de preparação e você pode começar a importar dados. Para obter ajuda na importação de dados do DynamoDB, consulte Trabalho com a Janela de Acesso a Dados.

Configurações de conexão

Configurações básicas

Configuração	Descrição	Exemplo
Ponto de extremidade	Ponto de extremidade para comunicação. Se você está se conectando à AWS, especifique o ponto de extremidade do serviço DynamoDB na AWS. Se você está se conectando ao DynamoDB local, especifique o endereço IP do servidor.	dynamodb.[região].amazonaws.com, onde [region] é a região da AWS a ser usada pela conexão
DynamoDB local	Especifica se a conexão é com um servidor DynamoDB local ou com o serviço DynamoDB na AWS. O DynamoDB local é um banco de dados do lado do cliente compatível com a API completa do DynamoDB, mas que não manipula tabelas ou dados no próprio DynamoDB.	Habilitado
Porta	O número da porta TCP usada pelo servidor do DynamoDB local para ouvir as conexões dos clientes. O número de porta padrão usada pelo DynamoDB local é 8000.	8000
Região	A região de hospedagem para seus serviços da Amazon Web Services.	NORTHERNVIRGINIA
Autenticação	Especifica como o driver autentica conexões ao DynamoDB: Desabilitada - O driver autentica as conexões ao DynamoDB usando uma chave de acesso e uma chave secreta. Habilitada - O driver autentica as conexões ao DynamoDB usando um perfil de um arquivo de credenciais.	Desabilitado
Arquivo de credenciais	O caminho completo e o nome do arquivo de credenciais em que as credenciais de MFA foram salvas. A localização padrão é %APPDATA%\\CData\\AmazonDynamoDB Data Provider\\CredentialsFile.txt
Nome de perfil	O nome do perfil no arquivo de credenciais da AWS a ser usado.
Chave de acesso	A chave de acesso à sua conta da AWS. Esse valor pode ser acessado na página de credenciais de segurança da AWS.
Chave secreta	A chave secreta da sua conta da AWS. Esse valor pode ser acessado na página de credenciais de segurança da AWS.
Ativar sessão temporária	Especifica se o driver usa credenciais temporárias: Desabilitado - O driver não usa credenciais temporárias. Habilitado - O driver autentica as conexões ao DynamoDB usando credenciais temporárias. As credenciais temporárias consistem em uma chave de acesso, uma chave secreta e um token de sessão, válidos apenas por um período limitado.
Token de sessão temporária	O token de sessão a ser usado na conexão ao DynamoDB usando credenciais de segurança temporárias, válidas apenas por um período limitado.	3600

Configurações avançadas

Configuração	Descrição	Exemplo
Número de novas tentativas	O número máximo de vezes que o driver deve retransmitir uma solicitação ao banco de dados DynamoDB, caso a solicitação falhe com um erro recuperável.	10
Limitar taxa de transferência	A porcentagem do total de unidades de leitura provisionadas que o driver pode consumir. Por padrão, o driver pode consumir até 30% da taxa de transferência provisionada. Certifique-se de usar um valor adequado ao número de aplicativos cliente que usarão uma tabela específica ao mesmo tempo. Por exemplo, se você definir esse valor como 100, um cliente usará todas as unidades de taxa de transferência provisionadas, impedindo que qualquer outro cliente use a tabela até que uma taxa de transferência adicional seja disponibilizada.	30
Local de metadados ativos	Especifica se a definição de esquema a ser usada é de um banco de dados ou de um arquivo local.	Banco de dados
Banco de dados	O nome da tabela de banco de dados que contém a definição do esquema a ser usado pelo driver na conexão ao DynamoDB.
Arquivo local	O caminho completo de um arquivo JSON local que contém a definição do esquema a ser usado pelo driver na conexão ao DynamoDB.

Atualizações de conector de dados

Quando atualiza o Analytics ou o Agente do Robôs, você deve testar todos os scripts que importam dados usando um dos conectores de dados do Analytics (comando ACCESSDATA).

É possível que alterações feitas por fornecedores externos de fontes de dados ou drivers ODBC exigiram atualizações em um ou mais conectores de dados. Pode ser necessário atualizar as conexões de dados com script para que continuem a funcionar corretamente.

• Execute novamente a importação A maneira mais fácil de atualizar uma conexão é executar manualmente uma importação usando a janela Acesso a Dados na versão atualizada do Analytics. Copie o comando ACCESSDATA do log e use-o para atualizar o script.

  Nota

  Antes de se conectar a uma fonte de dados e executar novamente a importação, limpe o cache do conector para remover o conjunto existente de nomes de tabelas.

  Na guia Conexões existentes na janela Acesso a Dados, ao lado do nome do conector, selecione > Limpar cache.

• Atualize as especificações de campos Também pode ser necessário atualizar as especificações de campos no corpo do script para compatibilizá-lo com as alterações do esquema da tabela na fonte de dados ou no driver ODBC. As possíveis alterações incluem nomes de campos, tipos de dados de campos e comprimentos de campos e registro.
• Verifique os resultados de todas as filtragens Você também deve verificar os resultados de qualquer filtragem aplicada durante a importação de dados. Confirme se a filtragem de importação está incluindo e excluindo corretamente os registros.