Detalhes da Conexão do Amazon Dynamo DB

Introdução

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando

Suporte à versão do Amazon DynamoDB

O conector usa a versão atual da API REST do Amazon DynamoDB, versão 2012-08-10, para habilitar o acesso de leitura/gravação às instâncias do DynamoDB.

Estabelecendo uma Conexão

Conectando-se ao DynamoDB

Especifique o seguinte para se conectar aos dados:

• Domain: Defina isso se quiser usar um nome de domínio associado à AWS.
• AWSRegion: Defina como a região onde seus dados do Amazon DynamoDB estão hospedados.

Autenticação no DynamoDB

Obtendo a Chave de Acesso

Para obter as credenciais de um usuário do IAM, siga as etapas abaixo:

1. Faça login no console do IAM.
2. No painel de navegação, selecione Usuários.
3. Para criar ou gerenciar as chaves de acesso para um usuário, selecione o usuário e, em seguida, selecione a aba Credenciais de segurança.

Para obter as credenciais para sua conta raiz da AWS, siga as etapas abaixo:

1. Faça login no console de gerenciamento da AWS com as credenciais de sua conta root.
2. Selecione o nome ou número da sua conta e selecione Minhas credenciais de segurança no menu exibido.
3. Clique em Continuar para credenciais de segurança e expanda a seção Chaves de acesso para gerenciar ou criar chaves de acesso de conta raiz.

Autenticação com Credenciais Raiz

Para autenticar usando credenciais raiz da conta, defina o seguinte:

• AuthScheme: Defina para AwsRootKeys.
• AWSAccessKey: A chave de acesso associada à conta root da AWS.
• AWSSecretKey: A chave secreta associada à conta raiz da AWS.

Observação: O uso desse esquema de autenticação é desencorajado pela Amazon para testes simples. As credenciais raiz da conta têm todas as permissões do usuário, tornando esse o método de autenticação menos seguro.

Autenticação com Credenciais Temporárias

Para autenticar usando credenciais temporárias, especifique o seguinte:

• AuthScheme: Defina para TemporaryCredentials.
• AWSAccessKey: A chave de acesso do usuário do IAM para o qual assumir a papel.
• AWSSecretKey: A chave secreta do usuário do IAM para o qual assumir a papel.
• AWSSessionToken: Seu token de sessão da AWS. Isso será fornecido junto com suas credenciais temporárias. Veja este link para mais informações.

O conector agora pode solicitar recursos usando as mesmas permissões fornecidas por credenciais de longo prazo (como credenciais de usuário do IAM) durante a vida útil das credenciais temporárias.

Se você também estiver usando uma papel do IAM para autenticação, deverá especificar adicionalmente o seguinte:

• AWSRoleARN: Especifique o Role ARN para a papel com a qual você gostaria de se autenticar. Isso fará com que o conector tente recuperar credenciais para a papel especificada.
• AWSExternalId: Somente se necessário quando você assume uma papel em outra conta.

Autenticação de uma Instância do EC2

Se você estiver usando o conector de uma instância EC2 e tiver uma função IAM atribuída à instância, poderá usar a função IAM para autenticar. Para fazer isso, defina as seguintes propriedades para autenticar:

• AuthScheme: Defina para AwsEC2Roles.

Não especifica AWSAccessKey e AWSSecretKey porque o conector obterá automaticamente suas credenciais de função IAM e autenticará com elas.

Se você também estiver usando uma papel do IAM para autenticação, deverá especificar adicionalmente o seguinte:

• AWSRoleARN: Especifique o Role ARN para a papel com a qual você gostaria de se autenticar. Isso fará com que o conector tente recuperar credenciais para a papel especificada.
• AWSExternalId: Somente se necessário quando você assume uma papel em outra conta.

Suporte IMDSv2

O conector Amazon DynamoDB agora oferece suporte a IMDSv2. Ao contrário do IMDSv1, a nova versão requer um token de autenticação. Endpoints e resposta são os mesmos em ambas as versões. No IMDSv2, o conector Amazon DynamoDB primeiro tenta recuperar o token de metadados IMDSv2 e, em seguida, usa-o para chamar endpoints de metadados da AWS. Se não for possível recuperar o token, o conector será revertido para IMDSv1.

Autenticação Como uma Função da AWS

Em muitas situações, pode ser preferível usar uma papel do IAM para autenticação em vez das credenciais de segurança diretas de um usuário raiz da AWS.

Para autenticar como uma papel da AWS, defina o seguinte:

• AuthScheme: Defina para AwsIAMRoles.
• AWSRoleARN: Especifique o Role ARN para a papel com a qual você gostaria de se autenticar. Isso fará com que o conector tente recuperar credenciais para a papel especificada.
• AWSExternalId: Somente se necessário quando você assume uma papel em outra conta.
• AWSAccessKey: A chave de acesso do usuário do IAM para o qual assumir a papel.
• AWSSecretKey: A chave secreta do usuário do IAM para o qual assumir a papel.

Observação: As funções não podem ser usadas ao especificar o AWSAccessKey e AWSSecretKey de um usuário raiz da AWS.

Autenticação com ADFS

Colocou o AuthScheme para ADFS. As seguintes propriedades de conexão precisam ser definidas:

• User: Defina isso para o usuário ADFS.
• Password: Defina como senha do ADFS para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.

Abaixo está um exemplo de string de conexão:

AuthScheme=ADFS; AWSRegion=Ireland; User=user@cdata.com; Password=CH8WerW121235647iCa6; SSOLoginURL='https://adfs.domain.com'; AWSRoleArn=arn:aws:iam:1234:role/ADFS_SSO; AWSPrincipalArn=arn:aws:iam:1234:saml-provider/ADFSProvider; S3StagingDirectory=s3://athena/staging;

ADFS Integrado

O fluxo integrado do ADFS indica que você está se conectando com o currently logged in Windows user credentials. Para usar o fluxo integrado do ADFS, simplesmente não especifique o User e Password, mas siga as mesmas etapas no guia ADFS acima.

Autenticação com Okta

Colocou o AuthScheme para Okta. As seguintes propriedades de conexão são usadas para se conectar ao Okta:

• User: Defina isso para o usuário Okta.
• Password: Defina como senha Okta para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.

A seguir SSOProperties são necessários para autenticar no Okta:

• APIToken (opcional): defina como o API Token que o cliente criou a partir da organização Okta. Ele deve ser usado ao autenticar um usuário por meio de um aplicativo ou proxy confiável que substitui o contexto de solicitação do cliente OKTA.
• MFAType (opcional): Defina isso apenas caso você tenha configurado o fluxo de MFA. Atualmente suportamos apenas os seguintes tipos: OktaVerify, E-mail e SMS.
• MFAPassCode (opcional): Defina isso apenas caso você tenha configurado o fluxo de MFA. Se estiver definido como vazio/inválido, o driver emitirá inicialmente um desafio de MFA que acionará a plataforma para enviar a você uma senha de uso único em seu dispositivo ou e-mail, com base no tipo de MFA configurado. Você precisa reemitir outra conexão em que o valor da senha única recuperada é passado para a propriedade de conexão MFAPassCode.

Veja a seguir um exemplo de string de conexão:

AuthScheme=Okta; AWSRegion=Ireland; User=user@cdata.com; Password=CH8WerW121235647iCa6; SSOLoginURL='https://cdata-us.okta.com/home/amazon_aws/0oa35m8arsAL5f5NrE6NdA356/272'; SSOProperties='ApiToken=01230GGG2ceAnm_tPAf4MhiMELXZ0L0N1pAYrO1VR-hGQSf;'; AWSRoleArn=arn:aws:iam:1234:role/Okta_SSO; AWSPrincipalARN=arn:aws:iam:1234:saml-provider/OktaProvider; S3StagingDirectory=s3://athena/staging;

Autenticação com PingFederate

Colocou o AuthScheme para PingFederate. As seguintes propriedades de conexão precisam ser definidas:

• User: Defina isso para o usuário PingFederate.
• Password: Defina como senha PingFederate para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.
• SSOExchangeUrl: O URI 'Partner Service Identifier' configurado em sua instância do servidor PingFederate em: SP Connections > SP Connection > WS-Trust > Protocol Settings. Isso deve identificar exclusivamente uma conexão PingFederate SP, portanto, é uma boa ideia defini-la como 'AWS SSO ACS URL'. Você pode encontrá-lo em AWS SSO > Configurações > Clique em 'Exibir detalhes' ao lado do campo Autenticação.

A seguir SSOProperties são necessários para autenticar no PingFederate:

• AuthScheme (opcional): o esquema de autorização a ser usado para o endpoint IdP. Os valores permitidos para este IdP são Nenhum ou Básico.

Além disso, você pode usar o seguinte SSOProperties para configurar autenticação SSL mútua para SSOLoginURL, o endpoint WS-Trust STS:

• SSLClientCert
• SSLClientCertType
• SSLClientCertSubject
• SSLClientCertPassword

Abaixo está um exemplo de string de conexão:

authScheme=pingfederate;SSOLoginURL=https://mycustomserver.com:9033/idp/sts.wst;SSOExchangeUrl=https://us-east-1.signin.aws.amazon.com/platform/saml/acs/764ef411-xxxxxx;user=admin;password=PassValue;AWSPrincipalARN=arn:aws:iam:215338515180:saml-provider/pingFederate;AWSRoleArn=arn:aws:iam:215338515180:role/SSOTest2;

Autenticação com MFA

Para usuários e funções que exigem autenticação multifator, especifique o seguinte para autenticar:

• AuthScheme: Defina para AwsMFA.
• CredentialsLocation: O local do arquivo de configurações onde as credenciais MFA são salvas. Consulte a página Local do arquivo de credenciais em Propriedades de configurações avançadas para obter mais informações.
• MFASerialNumber: O número de série do dispositivo MFA, se estiver sendo usado.
• MFAToken: O token temporário disponível no seu dispositivo MFA.

Se você estiver se conectando à AWS (em vez de já estar conectado, como em uma instância do EC2), deverá especificar adicionalmente o seguinte:

• AWSAccessKey: A chave de acesso do usuário IAM para quem o MFA será emitido.
• AWSSecretKey: A chave secreta do usuário do IAM para quem o MFA será emitido.

Se você também estiver usando uma papel do IAM para autenticação, deverá especificar adicionalmente o seguinte:

• AWSRoleARN: Especifique o Role ARN para a papel com a qual você gostaria de se autenticar. Isso fará com que o conector tente recuperar credenciais para a papel especificada usando MFA.
• AWSExternalId: Somente se necessário quando você assume uma papel em outra conta.

Isso fará com que o conector envie as credenciais MFA em uma solicitação para recuperar credenciais de autenticação temporárias.

Observe que a duração das credenciais temporárias pode ser controlada por meio do TemporaryTokenDuration propriedade (padrão 3600 segundos).

Autenticação com um Arquivo de Credencial

Você pode usar um arquivo de credenciais para autenticar. Quaisquer configurações relacionadas à autenticação AccessKey/SecretKey, credenciais temporárias, autenticação de papel ou MFA serão usadas. Para fazer isso, defina as seguintes propriedades para autenticar:

• AuthScheme: Defina para AwsCredentialsFile.
• AWSCredentialsFile: Defina isso para o local do seu arquivo de credenciais.
• AWSCredentialsFileProfile: Opcionalmente, defina isso com o nome do perfil que você gostaria de usar no arquivo de credenciais especificado. Se não for especificado, será usado o perfil com o nome padrão.

Veja este link Para maiores informações.

Autenticação com Credenciais do AWS Cognito

Se você deseja usar o conector com um usuário registrado em um grupo de usuários no AWS Cognito, defina as seguintes propriedades para autenticação:

• AuthScheme: Defina como AwsCognitoSrp (recomendado). Você também pode usar AwsCognitoBasic.
• AWSCognitoRegion: Defina isso para a região do User Pool.
• AWSUserPoolId: Defina isso para o ID do grupo de usuários.
• AWSUserPoolClientAppId: Defina isso para o ID do aplicativo do cliente do grupo de usuários.
• AWSUserPoolClientAppSecret: Defina isso como o Segredo do cliente do pool de usuários.
• AWSIdentityPoolId: Defina isso para o ID do pool de identidades do pool de identidades que está vinculado ao pool de usuários.
• User: Defina para o nome de usuário do usuário registrado no User Pool.
• Password: Configure com a senha do usuário cadastrado no User Pool.

Acesso a Dados de Ajuste Fino

Inferindo o Tipo de Dados

Você pode usar as seguintes propriedades para configurar a detecção automática de tipo de dados, que é habilitada por padrão.

• TypeDetectionScheme: Você pode usar esta propriedade para ativar ou desativar a detecção automática de tipo com base no valor especificado em RowScanDepth.
• RowScanDepth: Esta propriedade determina o número de linhas que serão verificadas para determinar os tipos de dados da coluna.
• IgnoreTypes: Os tipos de dados que devem ser ignorados e resolvidos para tipos de dados varchar. Por padrão, os tipos Date, Time e Datetime são ignorados. Isso ocorre porque o Amazon DynamoDB não oferece suporte a eles como tipos. Qualquer filtragem dessas colunas pode ser feita apenas como seu tipo de dados varchar original.

Acesso a Dados de Ajuste Fino

Você pode usar as seguintes propriedades para obter maior controle sobre os recursos da API do Amazon DynamoDB e as estratégias que o conector usa para exibi-los:

• GenerateSchemaFiles: Esta propriedade permite que você persista os metadados da tabela em arquivos de esquema estáticos fáceis de personalizar, para alterar os tipos de dados da coluna, por exemplo. Você pode definir esta propriedade como "OnStart" para gerar arquivos de esquema para todas as tabelas em seu banco de dados na conexão. Ou você pode gerar esquemas enquanto executa consultas SELECT em tabelas. Os esquemas resultantes são baseados nas propriedades de conexão que você usa para configurar Automatic Schema Discovery.

• UseSimpleNames: Amazon DynamoDB oferece suporte a nomes de atributos com caracteres especiais que muitas ferramentas orientadas a banco de dados não oferecem suporte.

  Além disso, os nomes das tabelas do Amazon DynamoDB podem incluir pontos e traços -- o conector interpreta os pontos nos nomes das tabelas como separadores hierárquicos que permitem detalhar os campos aninhados, semelhante ao XPath.

  Você pode usar esta propriedade para substituir qualquer caractere não alfanumérico por um sublinhado.

• SeparatorCharacter: Você pode usar esta propriedade para acessar mais facilmente os campos aninhados ao Consultar documentos e listas; especifique o separador de hierarquia com esta propriedade. Por padrão, esse caractere é o '.' (ponto) caractere.

Desempenho

Definindo um Intervalo de Repetição

Você pode definir as seguintes propriedades para repetir as consultas em vez de gerar um erro temporário, como "taxa máxima de transferência excedida":

• RetryWaitTime: O número mínimo de milissegundos que o conector aguardará para tentar novamente uma solicitação.
• MaximumRequestRetries: O número máximo de vezes para repetir uma solicitação.

O conector Jitterbit para Amazon DynamoDB também possui duas APIs separadas que podem ser usadas dependendo da consultar, PartiQL e Scan. A API utilizada depende da consultar executada.

PartiQL

O PartiQL é usado em qualquer consultar de solicitação de inserção/atualização/exclusão, bem como em qualquer seleção que contenha um filtro. Isso ocorre porque a API PartiQL contém recursos de filtragem mais avançados do que o endpoint Scan mais antigo. Em geral, espera-se que as consultas em que uma parte significativa do resultado é filtrada sejam executadas mais rapidamente do que uma consultar com muito pouco filtrado.

Usando a Paginação de Forma Eficaz

Você pode usar o Pagesize propriedade para otimizar o uso de sua taxa de transferência provisionada, com base no tamanho de seus itens e no tamanho de página de 1 MB do Amazon DynamoDB. Configure esta propriedade para o número de itens a serem retornados.

Geralmente, um tamanho de página menor reduz os picos na taxa de transferência que causam throttling. Um tamanho de página menor também insere pausas entre as solicitações. Esse intervalo equilibra a distribuição de solicitações e permite que mais solicitações sejam bem-sucedidas, evitando throttling.

Digitalizações

Uma varredura ocorrerá durante uma consultar SELECT que não contém nenhum filtro. Neste caso, todos os resultados devem ser recuperados, portanto não há vantagem em utilizar a API do PartiQL. A execução de uma varredura recuperará todos os resultados, mas a API contém um recurso importante que oferece melhor desempenho do que uma consultar PartiQL não filtrada: vários encadeamentos.

O ThreadCount a propriedade de conexão pode ser definida para influenciar quantos threads serão usados ao executar uma solicitação de verificação. Usar mais threads fará com que mais memória seja ocupada, mas resultará em resultados mais rápidos por thread. O padrão é 4. Isso funciona melhor em tabelas em que uma taxa de transferência alta ou variável é provisionada.

Nos casos em que o throughput máximo de uma tabela seria excedido em um único encadeamento, não há benefício em usar um Scan sobre a API PartiQL de encadeamento único. O Amazon DynamoDB simplesmente limitará todos os encadeamentos até que a taxa de transferência máxima não seja mais excedida.

Requisitos Mínimos de IAM

Recomendamos o uso de funções predefinidas para serviços em vez de criar políticas de IAM personalizadas. As funções predefinidas para o Amazon DynamoDB são

• AmazonDynamoDBReadOnlyAccess - concede acesso somente leitura aos recursos do DynamoDB por meio do Management Console da AWS.
• AmazonDynamoDBFullAccess - concede acesso total aos recursos do DynamoDB por meio do Management Console da AWS.

Se você deseja criar políticas personalizadas, use as funções descritas na tabela abaixo. Observe que as políticas específicas exigidas pelo driver Amazon DynamoDB estão sujeitas a alterações em versões futuras. O Amazon DynamoDB requer no mínimo as seguintes permissões:

Anotações Importantes

Procedimentos Armazenados

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Banco de Dados NoSQL

O Amazon DynamoDB é um banco de dados sem esquema que oferece alto desempenho, disponibilidade e escalabilidade. Esses recursos não são necessariamente incompatíveis com uma linguagem de consultar compatível com padrões como o SQL-92. Nesta seção, mostraremos vários esquemas que o conector oferece para preencher a lacuna com o SQL relacional e um banco de dados de documentos.

O conector modela as tabelas Amazon DynamoDB sem esquema em tabelas relacionais e converte consultas SQL em consultas Amazon DynamoDB para obter os dados solicitados. O conector oferece duas maneiras, Automatic Schema Discovery e Definições de esquema personalizado, para modelar tabelas do Amazon DynamoDB como tabelas relacionais.

A Descoberta Automática de Esquema localiza automaticamente os tipos de dados em uma tabela do Amazon DynamoDB verificando um número configurado de linhas da tabela. Você pode usar RowScanDepth, FlattenArrays, e FlattenObjects para controlar a representação relacional das tabelas no Amazon DynamoDB.

Opcionalmente, você pode usar Definições de esquema personalizado para projetar a estrutura relacional escolhida sobre uma tabela do Amazon DynamoDB. Isso permite que você defina os nomes das colunas escolhidas, seus tipos de dados e a localização de seus valores na tabela do Amazon DynamoDB.

Descoberta Automática de Esquema

O conector infere automaticamente um esquema relacional inspecionando uma série de documentos do Amazon DynamoDB em uma coleção. Você pode usar o RowScanDepth propriedade para definir a quantidade de documentos que o conector digitalizará para isso. As colunas identificadas durante o processo de descoberta dependem do FlattenArrays e FlattenObjects propriedades.

Objetos Achatados

Se FlattenObjects for definido, todos os objetos aninhados serão nivelados em uma série de colunas. Por exemplo, considere o seguinte documento:

{
  id: 12,
  name: "Lohia Manufacturers Inc.",
  address: {street: "Main Street", city: "Chapel Hill", state: "NC"},
  offices: ["Chapel Hill", "London", "New York"],
  annual_revenue: 35,600,000
}

Este documento será representado pelas seguintes colunas:

Se FlattenObjects não for definido, as colunas address.street, address.city e address.state não serão separadas. A coluna de endereço do tipo string representará o objeto inteiro. Seu valor seria {street: "Main Street", city: "Chapel Hill", state: "NC"}. Consulte Funções JSON para obter mais detalhes sobre como trabalhar com agregados JSON. Você pode alterar o caractere separador no nome da coluna de um ponto definindo SeparatorCharacter.

Achatamento de Matrizes

O FlattenArrays a propriedade pode ser usada para nivelar os valores da matriz em colunas próprias. Isso é recomendado apenas para arrays que devem ser curtos, por exemplo, as coordenadas abaixo:

"coord": [-73.856077, 40.848447 ]

O FlattenArrays a propriedade pode ser definida como 2 para representar o array acima da seguinte forma:

É melhor deixar outras matrizes ilimitadas como estão e separar os dados para elas conforme necessário usando Funções JSON.

Achatamento Vertical

É possível recuperar um array de objetos como se fosse uma tabela separada. Pegue a seguinte estrutura JSON da tabela restaurantes, por exemplo:

{
  "restaurantid" : "30075445",
  "address" : {
    "building" : "1007",
    "coord" : [-73.856077, 40.848447],
    "street" : "Morris Park Ave",
    "zipcode" : "10462"
  },
  "borough" : "Bronx",
  "cuisine" : "Bakery",
  "grades" : [{
      "date" : 1393804800000,
      "grade" : "B",
      "score" : 2
    }, {
      "date" : 1378857600000,
      "grade" : "A",
      "score" : 6
    }, {
      "date" : 1358985600000,
      "grade" : "A",
      "score" : 10
    }],
  "name" : "Morris Park Bake Shop"
}

O nivelamento vertical permitirá que você recupere a matriz de notas como uma tabela separada usando a sintaxe abaixo:

SELECT * FROM [restaurants.grades]

Esta consultar retorna o seguinte conjunto de dados:

A matriz de notas também pode ser aninhada em alguns níveis mais profundos. Nesse caso, a mesma sintaxe deve ser usada:

SELECT * FROM [restaurants.cuisine.bakery.grades]

Também existem casos em que a estrutura aninhada inclui outra matriz em um nível superior. Tome o seguinte JSON como exemplo:

{
  "restaurantid" : "30075445",
  "reviews": [
   {
    "grades": [
     {
      "date": 1393804800000,
      "score": 2,
      "grade": "B"
     },
     {
      "date": 1378857600000,
      "score": 6,
      "grade": "A"
     },
     {
      "date": 1358985600000,
      "score": 10,
      "grade": "A"
     }]
    }],
  "name" : "Morris Park Bake Shop"
}

Para esta estrutura, o índice da matriz de comentários precisará ser colocado entre colchetes. Se eles já estiverem sendo usados como caracteres de escape na consultar SQL, os colchetes precisarão ser escapados, conforme mostrado na consultar abaixo:

SELECT * FROM [restaurants.reviews.\[0\].grades]

Essa consultar retornará o mesmo conjunto de dados da estrutura JSON na parte superior. Observe que essa sintaxe diferencia maiúsculas de minúsculas, portanto, certifique-se de escrever os nomes dos campos da mesma forma que eles são salvos no DynamoDB.

Funções JSON

O conector pode retornar estruturas JSON como valores de coluna. O conector permite usar funções SQL padrão para trabalhar com essas estruturas JSON. Os exemplos nesta seção usam a seguinte matriz:

[
     { "grade": "A", "score": 2 },
     { "grade": "A", "score": 6 },
     { "grade": "A", "score": 10 },
     { "grade": "A", "score": 9 },
     { "grade": "B", "score": 14 }
]

JSON_EXTRACT

A função JSON_EXTRACT pode extrair valores individuais de um objeto JSON. A consultar a seguir retorna os valores mostrados abaixo com base no caminho JSON passado como o segundo argumento para a função:

SELECT Name, JSON_EXTRACT(grades,'[0].grade') AS Grade, JSON_EXTRACT(grades,'[0].score') AS Score FROM Students;

JSON_COUNT

A função JSON_COUNT retorna o número de elementos em uma matriz JSON dentro de um objeto JSON. A consultar a seguir retorna o número de elementos especificados pelo caminho JSON passado como o segundo argumento para a função:

SELECT Name, JSON_COUNT(grades,'[x]') AS NumberOfGrades FROM Students;

JSON_SUM

A função JSON_SUM retorna a soma dos valores numéricos de uma matriz JSON em um objeto JSON. A consultar a seguir retorna o total dos valores especificados pelo caminho JSON passado como o segundo argumento da função:

SELECT Name, JSON_SUM(score,'[x].score') AS TotalScore FROM Students;

JSON_MIN

A função JSON_MIN retorna o menor valor numérico de uma matriz JSON dentro de um objeto JSON. A consultar a seguir retorna o valor mínimo especificado pelo caminho JSON passado como o segundo argumento para a função:

SELECT Name, JSON_MIN(score,'[x].score') AS LowestScore FROM Students;

JSON_MAX

A função JSON_MAX retorna o valor numérico mais alto de uma matriz JSON dentro de um objeto JSON. A consultar a seguir retorna o valor máximo especificado pelo caminho JSON passado como o segundo argumento para a função:

SELECT Name, JSON_MAX(score,'[x].score') AS HighestScore FROM Students;

Consultas do DynamoDB

Como o Amazon DynamoDB é uma fonte de dados NoSQL, as consultas precisam ser tratadas de maneira um pouco diferente dos bancos de dados relacionais padrão.

Consultas Sensíveis ao Valor

A falta de um tipo de dados obrigatório para uma determinada coluna significa que você pode armazenar diferentes tipos de dados em uma única coluna. Por exemplo, uma linha pode ter uma String chamada EmailAddresses e outra pode ter um StringSet também chamado EmailAddresses. Para esses e outros tipos de casos, o conector determina em grande parte qual tipo de dados usar com base nos valores da consultar.

Por exemplo, digamos que você tenha uma tabela de itens onde o PartNumber pode armazenar uma string ou um número. Para recuperar uma peça com o PartNumber do valor numérico 12345, você deve emitir a seguinte consultar:

SELECT Name, Location, Quantity, PartNumber FROM Items WHERE PartNumber = 12345

Alternativamente, o PartNumber poderia ter sido armazenado como a string "12345". Para recuperar uma peça com o PartNumber da string literal 12345, faça a seguinte consultar:

SELECT Name, Location, Quantity, PartNumber FROM Items WHERE PartNumber = '12345'

Se o tipo de dados do valor especificado não for ambíguo, ele sempre será usado antes do tipo de dados detectado automaticamente. Em ambos os casos, se um parâmetro for usado em vez de um valor codificado, o tipo de dados do parâmetro será usado para determinar qual tipo enviar ao Amazon DynamoDB.

Tipo de Dados da Coluna Detectada

Se um valor não for óbvio com base apenas no tipo de dados detectado, o conector o compara com a coluna detectada automaticamente. Por exemplo, se você deseja inserir uma coluna chamada Coordenadas na tabela Localização, sua inserção seria semelhante a:

INSERT INTO Locations (Address, Coordinates) VALUES ('123 Fake Street', '[40.7127, 74.0059]')

Com base apenas no valor de entrada, o tipo de dados detectado é uma string. No entanto, como uma coluna Coordenadas foi detectada automaticamente anteriormente, o conector insere um NumberSet e não uma String simples.

Se uma coluna Coordenadas não foi detectada automaticamente durante a varredura da tabela Locais, o tipo de dados do valor inserido é usado.

Nesse caso, ainda poderíamos resolver que a inserção é um NumberSet, mas custará um pouco mais de sobrecarga fazer isso.

Contar

O Amazon DynamoDB oferece suporte a 2 métodos diferentes de uso da função de agregação COUNT. Para simplesmente retornar o número de itens em sua tabela, emita a seguinte consultar:

SELECT COUNT(*) FROM MyTable

O conector Jitterbit para Amazon DynamoDB lerá o ItemCount da ação DescribeTable. Isso evita o uso de muitas unidades de leitura para varrer a tabela inteira. No entanto, o DynamoDB atualiza esse valor aproximadamente a cada seis horas e as alterações recentes podem não ser refletidas nesse valor.

A emissão das consultas de exemplo abaixo irá, em vez disso, varrer a tabela completa para contagem:

SELECT COUNT(*) FROM MyTable WHERE MyInt > 10
SELECT COUNT(MyInt) FROM MyTable

Consultar Documentos e Listas

Documentos e listas do Amazon DynamoDB são compatíveis com o Jitterbit Connector para Amazon DynamoDB. Você pode acessar documentos e listas diretamente no nível raiz ou usar o '.' caractere como um divisor de hierarquia para detalhar documentos e listas.

Valores de Relatório em Documentos e Listas

Quando os tipos de dados são detectados automaticamente, eles são relatados até o nível mais baixo que pode ser detectado de forma confiável. Por exemplo, um documento chamado Cliente com um filho chamado Endereço e um filho em Endereço chamado Rua seria representado pela coluna Cliente.Endereço.Rua.

No entanto, esse processo não se aplica a listas, pois uma lista pode ter qualquer número de entradas. Depois que uma lista ou um conjunto é detectado, os valores adicionais não são relatados como disponíveis no esquema da tabela.

Recuperando Valores Não Declarados

Se houver atributos que freqüentemente não possuem um valor e, portanto, não são detectados automaticamente, eles ainda podem ser recuperados especificando o caminho correto para eles. Por exemplo, para obter o atributo Especial do documento Cliente:

SELECT [Customer.Address.Street], [Cliente.Especial] FROM MyTable

Depois que uma lista é detectada, os valores adicionais não são relatados. Mas valores individuais na lista podem ser referenciados especificando '.' e um número. Por exemplo:

SELECT [MinhaLista.0], [MyList.1.Email], [MinhaLista.1.Idade] FROM MyTable

Isso recuperará o primeiro valor da lista e os atributos E-mail e Idade do segundo valor.

Inserindo Documentos e Listas

As inserções no Amazon DynamoDB exigem que o objeto completo seja especificado durante a inserção. Insira um documento ou lista na raiz. Passe o agregado JSON completo. Por exemplo:

INSERT INTO MyTable (PrimaryKey, EmailAddresses, Address, MyList) VALUES ('uniquekey', '["user@email.com", "user2@email2.com"]', '{"Street":"123 Fake Street", "City":"Chapel Hill", "Zip":"27713"}', '[{"S":"somestr"},{"NS":[1,2]},{"N":4}]')

Nesse caso, EmailAddress é inserido como um StringSet, Address é inserido como um documento e MyList é inserido como uma lista.

Atualização de Documentos e Listas

As atualizações são suportadas usando a mesma sintaxe disponível durante as seleções. Documentos e listas podem ser especificados usando o '.' caractere para especificar a hierarquia. Por exemplo:

UPDATE MyTable SET [EmailAddress.0]='user@email.com', [EmailAddress.1]='user2@email2.com', [Address.Street]='123 Fake Street', [Address.City]='Chapel Hill', [Address.Zip]='27713', [MyList.0]='somestr', [MyList.1]='[1,2]', [MyList.2]=4 WHERE PrimaryKey='uniquekey'

Observe que EmailAddress e MyList devem ser detectados automaticamente para resolver como lidar com EmailAddress de maneira diferente de MyList. Se você estiver em dúvida se algo será detectado automaticamente ou não, especificar o JSON completo para atualizar sempre funcionará.

Mapeamento de Tipo de Dados

Mapeamentos de Tipo de Dados

O conector mapeia os tipos da fonte de dados para o tipo de dados correspondente disponível no esquema. Além disso, tentaremos verificar os dados disponíveis voltando com base no IgnoreTypes propriedade de conexão. A tabela abaixo documenta esses mapeamentos.

Observe que, dependendo das configurações de IgnoreTypes, alguns desses tipos podem não ser detectados por padrão. Data, datahora e hora, por exemplo, são ignorados por padrão, pois não podem ser filtrados no lado do servidor e podem ser inseridos/atualizados em um formato diferente das entradas existentes, se ativados. Tenha cuidado ao ativá-los.

FlattenArrays e FlattenObjects também pode ser usado para nivelar StringSets, NumberSets, BinarySets, Maps e Lists em colunas individuais.

Definições de Esquema Personalizado

Além da descoberta automática de esquema, o conector também permite que você defina estaticamente o esquema para sua tabela do Amazon DynamoDB. Vamos considerar um esquema para o conjunto de dados dos restaurantes.

Abaixo está um exemplo de item da tabela:

{
   "address":{
      "building":"461",
      "coord":[
         -74.138492,
         40.631136
      ],
      "street":"Port Richmond Ave",
      "zipcode":"10302"
   },
   "borough":"Staten Island",
   "cuisine":"Other",
   "grades":[

   ],
   "name":"Indian Oven",
   "restaurant_id":"50018994"
}

Definindo um Esquema Personalizado

Você pode definir um esquema personalizado para extrair propriedades aninhadas como suas próprias colunas. Colocou o Location para o diretório do arquivo que conterá o arquivo de esquema.

O esquema a seguir usa a propriedade other:path para definir de onde os dados de uma determinada coluna devem ser recuperados. Usando este modelo, você pode achatar níveis arbitrários de hierarquia.

O atributo 'other:tableapiname' especifica a tabela a ser analisada. Esse atributo oferece a flexibilidade de usar vários esquemas para a mesma tabela.

Em Exemplo de esquema personalizado, você encontrará o esquema completo que contém o exemplo acima.

<api:info title="StaticRestaurants" other:catalog="" other:schema="AmazonDynamoDB" description="StaticRestaurants" other:tableapiname="StaticRestaurants"  other:version="20">
  <attr   name="id"      xs:type="decimal"   key="true"   columnsize="17"     precision="38"   scale="6"   readonly="false"   description="Dynamic Column."   other:dynamodatatype="N"   other:relativepath="restaurant_id"   other:filterable="true"   other:fullpath="restaurant_id"      other:apiname="&amp;quot;restaurant_id&amp;quot;"                          />
  <attr   name="borough"            xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="borough"         other:filterable="true"   other:fullpath="borough"            other:apiname="&amp;quot;borough&amp;quot;"                                />
  <attr   name="address_zipcode"    xs:type="int"                    columnsize="4"      precision="10"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="zipcode"         other:filterable="true"   other:fullpath="address.zipcode"    other:apiname="&amp;quot;address&amp;quot;.&amp;quot;zipcode&amp;quot;"    />
  <attr   name="address_coord_0"    xs:type="double"                 columnsize="8"      precision="15"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="N"   other:relativepath="coord"           other:filterable="true"   other:fullpath="address.coord[0]"   other:apiname="&amp;quot;address&amp;quot;.&amp;quot;coord&amp;quot;[0]"   />
  <attr   name="address_coord_1"    xs:type="double"                 columnsize="8"      precision="15"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="N"   other:relativepath="coord[1]"        other:filterable="true"   other:fullpath="address.coord[1]"   other:apiname="&amp;quot;address&amp;quot;.&amp;quot;coord&amp;quot;[1]"   />
  <attr   name="address_building"   xs:type="int"                    columnsize="4"      precision="10"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="building"        other:filterable="true"   other:fullpath="address.building"   other:apiname="&amp;quot;address&amp;quot;.&amp;quot;building&amp;quot;"   />
  <attr   name="address_street"     xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="street"          other:filterable="true"   other:fullpath="address.street"     other:apiname="&amp;quot;address&amp;quot;.&amp;quot;street&amp;quot;"     />
  <attr   name="name"               xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="name"            other:filterable="true"   other:fullpath="name"               other:apiname="&amp;quot;name&amp;quot;"                                   />
  <attr   name="cuisine"            xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="cuisine"         other:filterable="true"   other:fullpath="cuisine"            other:apiname="&amp;quot;cuisine&amp;quot;"                                />
</api:info>

Exemplo de Esquema Personalizado

Esta seção contém um esquema completo. A seção de informações permite uma visualização relacional de uma tabela do Amazon DynamoDB. Para obter mais detalhes, consulte Definições de esquema personalizado. A tabela abaixo permite os comandos SELECT, INSERT, UPDATE e DELETE conforme implementados nas seções GET, POST, MERGE e DELETE do esquema abaixo. Colocou o Location para o diretório do arquivo que conterá o arquivo de esquema.

Use o atributo 'other:tableapiname' para especificar o nome da tabela do Amazon DynamoDB que você deseja analisar. Você pode usar o atributo 'other:tableapiname' para definir vários esquemas para a mesma tabela. Observação: Amazon DynamoDB diferencia maiúsculas de minúsculas. O nome da tabela e os caminhos especificados devem corresponder à forma como seus campos aparecem no Amazon DynamoDB.

As operações, como dynamodbadoProviderOperationCaller, são implementações internas e também podem ser copiadas como estão.

<api:script xmlns:api="http://apiscript.com/ns?v1" xmlns:xs="http://www.cdata.com/ns/rsbscript/2" xmlns:other="http://apiscript.com/ns?v1">
  <api:info title="StaticRestaurants" other:catalog="" other:schema="AmazonDynamoDB" description="StaticRestaurants" other:tableapiname="StaticRestaurants"  other:version="20">
    <attr   name="id"      xs:type="decimal"   key="true"   columnsize="17"     precision="38"   scale="6"   readonly="false"   description="Dynamic Column."   other:dynamodatatype="N"   other:relativepath="restaurant_id"   other:filterable="true"   other:fullpath="restaurant_id"      other:apiname="&amp;quot;restaurant_id&amp;quot;"                          />
    <attr   name="borough"            xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="borough"         other:filterable="true"   other:fullpath="borough"            other:apiname="&amp;quot;borough&amp;quot;"                                />
    <attr   name="address_zipcode"    xs:type="int"                    columnsize="4"      precision="10"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="zipcode"         other:filterable="true"   other:fullpath="address.zipcode"    other:apiname="&amp;quot;address&amp;quot;.&amp;quot;zipcode&amp;quot;"    />
    <attr   name="address_coord_0"    xs:type="double"                 columnsize="8"      precision="15"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="N"   other:relativepath="coord"           other:filterable="true"   other:fullpath="address.coord[0]"   other:apiname="&amp;quot;address&amp;quot;.&amp;quot;coord&amp;quot;[0]"   />
    <attr   name="address_coord_1"    xs:type="double"                 columnsize="8"      precision="15"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="N"   other:relativepath="coord[1]"        other:filterable="true"   other:fullpath="address.coord[1]"   other:apiname="&amp;quot;address&amp;quot;.&amp;quot;coord&amp;quot;[1]"   />
    <attr   name="address_building"   xs:type="int"                    columnsize="4"      precision="10"               readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="building"        other:filterable="true"   other:fullpath="address.building"   other:apiname="&amp;quot;address&amp;quot;.&amp;quot;building&amp;quot;"   />
    <attr   name="address_street"     xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="street"          other:filterable="true"   other:fullpath="address.street"     other:apiname="&amp;quot;address&amp;quot;.&amp;quot;street&amp;quot;"     />
    <attr   name="name"               xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="name"            other:filterable="true"   other:fullpath="name"               other:apiname="&amp;quot;name&amp;quot;"                                   />
    <attr   name="cuisine"            xs:type="string"                 columnsize="2000"                                readonly="false"   description="Dynamic Column."   other:dynamodatatype="S"   other:relativepath="cuisine"         other:filterable="true"   other:fullpath="cuisine"            other:apiname="&amp;quot;cuisine&amp;quot;"                                />
  </api:info>


  <api:script method="GET">
    <api:call op="dynamodbadoProviderOperationCaller">
      <api:push/>
    </api:call>
  </api:script>

  <api:script method="POST">
    <api:call op="dynamodbadoProviderOperationCaller">
      <api:push/>
    </api:call>
  </api:script>

  <api:script method="MERGE">
    <api:call op="dynamodbadoProviderOperationCaller">
      <api:push/>
    </api:call>
  </api:script>

  <api:script method="DELETE">
    <api:call op="dynamodbadoProviderOperationCaller">
      <api:push/>
    </api:call>
  </api:script>
</api:script>

Características Avançadas

Esta seção detalha uma seleção de recursos avançados do conector Amazon DynamoDB.

Detecção automática de índice

O AutoDetectIndex propriedade fornece acesso rápido aos itens em uma tabela detectando um índice alternativo que pode ser consultado no lugar da própria tabela. Esse índice secundário é uma estrutura de dados que contém um subconjunto de atributos de uma tabela e uma chave alternativa. O benefício de consultar um índice em vez da tabela principal é pular uma verificação completa da tabela principal. Isso torna a operação muito mais rápida.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visualizações definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário

O Jitterbit Connector para Amazon DynamoDB permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Account WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL

Personalizando a Configuração SSL

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados

O conector permite que você acesse dados no Amazon DynamoDB usando uma interface semelhante a um banco de dados padrão. O Amazon DynamoDB é um banco de dados em nuvem NoSQL altamente escalável, muito diferente de um banco de dados comum. Nesta seção, descrevemos como modelamos tabelas do Amazon DynamoDB sem esquema como Tabelas e Procedimentos Armazenados.

O conector pode detectar esquemas dinamicamente no momento da conexão. Consulte Descoberta automática de esquema para obter mais informações sobre como definir esquemas implicitamente no momento da conexão. Este método é útil se a estrutura de seus dados for volátil.

Você também pode persistir esquemas em definições de esquema estático. Os arquivos de esquema do conector têm um formato simples. Consulte Definições de esquema personalizado para obter mais informações sobre como definir e estender esquemas estáticos.

Tabelas

A lista de tabelas é recuperada dinamicamente de sua conta do Amazon DynamoDB. Você pode usar o procedimento armazenado* para criar uma nova tabela ou você pode criar uma tabela usando o Amazon Web Services Admin Console.

Como as tabelas do DynamoDB são particionadas com base em suas chaves, você deve ter cuidado ao selecionar uma chave adequada com base nos requisitos de consultar de sua tabela. Consulte a documentação do DynamoDB para obter mais informações sobre como usar as práticas recomendadas para modelar dados em tabelas do DynamoDB. O DynamoDB oferece suporte a dois tipos de chaves primárias:

• Chave Primária Hash: Esta é uma chave de coluna única.
• Chave primária de hash e intervalo: esta é uma chave de duas colunas que inclui uma coluna de hash e uma coluna de intervalo.

O conector modelará todos os atributos de chave no DynamoDB como colunas de chave.

Colunas da Tabela

Como as tabelas do Amazon DynamoDB não têm esquema, o conector oferece os dois mecanismos a seguir para descobrir o esquema.

Esquemas Dinâmicos

As colunas de uma tabela são determinadas dinamicamente pela varredura de dados nas primeiras linhas. Você pode ajustar o número de linhas usadas modificando o RowScanDepth propriedade. Além do nome da coluna, a varredura de linha também determina o tipo de dados. A tabela a seguir mostra como os diferentes tipos de dados compatíveis com o Amazon DynamoDB são modelados no conector.

Esquemas Estáticos

Em vez de usar esquemas descobertos dinamicamente, você pode definir seus próprios esquemas. Isso lhe dará mais controle sobre as colunas projetadas e também permitirá que você use outros tipos de dados, como booleanos, datahora, etc. Consulte CreateSchema Procedimento armazenado* para criar seu próprio esquema. Você pode simplesmente especificar o FileName (fullpath) e o TableName do novo arquivo de esquema, que deve corresponder ao nome da tabela do Amazon DynamoDB, e editar a listagem de colunas para usá-la em sua própria tabela.

Operações Sem Esquema

Embora o esquema da tabela seja necessário para relatar os metadados, os dados podem ser selecionados, inseridos, atualizados ou excluídos de colunas que não existem no esquema. As colunas que ainda não existem no esquema da tabela terão seus tipos de dados determinados dinamicamente com base nos dados especificados. Consulte Consultas do DynamoDB Para maiores informações.

Procedimentos Armazenados

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no NoSQL Database. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Amazon DynamoDB

Criar Esquema

Cria um arquivo de esquema para a tabela ou exibição especificada.

Entrada

Colunas do Conjunto de Resultados

Criar a Tabela

Cria uma tabela no DynamoDB.

Entrada

Colunas do Conjunto de Resultados

Tabelas do Sistema

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema

As tabelas a seguir retornam metadados de banco de dados para Amazon DynamoDB:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de Fonte de Dados

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados, incluindo operações em lote:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas

Sys_schemas

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas

Sys_tables

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas

Sys_tablecolumns

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e os tipos de dados da tabela Account:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Account' 

Colunas

Sys_procedures

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures

Colunas

Sys_procedureparameters

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado CreateSchema:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='CreateSchema' AND Direction=1 OR Direction=2

Colunas

Sys_keycolumns

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela Account:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Account'

Colunas

Sys_foreignkeys

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Colunas

Sys_indexes

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Colunas

Sys_connection_props

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:amazondynamodb:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''

Colunas

Sys_sqlinfo

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Processamento de Consulta Colaborativa

Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.

Descobrindo os Recursos SELECT da Fonte de Dados

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.

A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Banco de Dados NoSQL para obter mais informações.

Colunas

Sys_identity

Retorna informações sobre tentativas de modificação.

A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:

SELECT * FROM sys_identity

Colunas

Propriedades de Configurações Avançadas

As propriedades de configurações avançadas são as várias opções que podem ser usadas para estabelecer uma conexão. Esta seção fornece uma lista completa das opções que você pode configurar. Clique nos links para mais detalhes.

Autenticação da AWS

SSO

SSL

Esquema

Diversos

Autenticação da AWS

Esta seção fornece uma lista completa das propriedades de autenticação da AWS que você pode configurar.

AuthScheme

O esquema usado para autenticação. As entradas aceitas são: Auto,, AwsRootKeys, AwsIAMRoles, AwsEC2Roles, AwsMFA, ADFS, Okta, PingFederate, AwsCredentialsFile, AwsCognitoBasic, AwsCognitoSrp.

Valores Possíveis

Auto, ADFS, AwsRootKeys, AwsIAMRoles, AwsEC2Roles, AwsMFA, AwsCredentialsFile, Okta, TemporaryCredentials, PingFederate, AwsCognitoBasic, AwsCognitoSrp

Tipo de Dados

string

Valor Padrão

"Auto"

Observações

Use as seguintes opções para selecionar seu esquema de autenticação:

• Automático: defina para que o conector tente resolver automaticamente o esquema de autenticação adequado a ser usado com base nas outras propriedades de conexão especificadas.
• TemporaryCredentials: defina isso para aproveitar as credenciais de segurança temporárias junto com um token de sessão para se conectar.
• AwsRootKeys: defina isso para usar a chave de acesso e o segredo do usuário root. Útil para testes rápidos, mas os casos de uso de produção são encorajados a usar algo com permissões restritas.
• AwsIAMRoles: definido para usar funções IAM para a conexão.
• AwsEC2Roles: defina isso para usar automaticamente as funções IAM atribuídas à máquina EC2 em que o conector Jitterbit para Amazon DynamoDB está sendo executado no momento.
• AwsMFA: definido para usar a autenticação multifator.
• Okta: Defina para usar uma conexão de logon único com OKTA como o provedor de identidade.
• ADFS: definido para usar uma conexão de logon único com ADFS como o provedor de identidade.
• PingFederate: definido para usar uma conexão de logon único com PingFederate como o provedor de identidade.
• AwsCredentialsFile: definido para usar um arquivo de credencial para autenticação.
• AwsCognitoSrp: definido para usar a autenticação baseada em Cognito. Isso é recomendado sobre AwsCognitoBasic porque essa opção NÃO envia a senha ao servidor para autenticação, em vez disso, usa o protocolo SRP.
• AwsCognitoBasic: definido para usar a autenticação baseada em Cognito.

Domínio

Seu nome de domínio da AWS. Opcionalmente, você pode optar por associar seu nome de domínio à AWS.

Tipo de Dados

string

Valor Padrão

"amazonaws.com"

Observações

Se você não tiver um nome de domínio exclusivo da AWS, deixe esse valor especificado como amazonaws.com.

AWSAccessKey

Sua chave de acesso da conta da AWS. Esse valor pode ser acessado na página de credenciais de segurança da AWS.

Tipo de Dados

string

Valor Padrão

""

Observações

Sua chave de acesso da conta da AWS. Esse valor pode ser acessado na página de credenciais de segurança da AWS:

1. Faça login no console de gerenciamento da AWS com as credenciais de sua conta raiz.
2. Selecione o nome ou número da sua conta e selecione Minhas credenciais de segurança no menu exibido.
3. Clique em Continuar para credenciais de segurança e expanda a seção Chaves de acesso para gerenciar ou criar chaves de acesso de conta raiz.

AWSSecretKey

A chave secreta da sua conta da AWS. Esse valor pode ser acessado na página de credenciais de segurança da AWS.

Tipo de Dados

string

Valor Padrão

""

Observações

A chave secreta da sua conta da AWS. Esse valor pode ser acessado na página de credenciais de segurança da AWS:

1. Faça login no console de gerenciamento da AWS com as credenciais de sua conta root.
2. Selecione o nome ou número da sua conta e selecione Minhas credenciais de segurança no menu exibido.
3. Clique em Continuar para credenciais de segurança e expanda a seção Chaves de acesso para gerenciar ou criar chaves de acesso de conta raiz.

AWSRoleARN

O nome de recurso da Amazon da papel a ser usada durante a autenticação.

Tipo de Dados

string

Valor Padrão

""

Observações

Ao autenticar fora da AWS, é comum usar uma função para autenticação em vez de suas credenciais diretas da conta da AWS. Entrando no AWSRoleARN fará com que o Conector Jitterbit para Amazon DynamoDB execute uma autenticação baseada em papel em vez de usar a AWSAccessKey e AWSSecretKey diretamente. A AWSAccessKey e AWSSecretKey ainda deve ser especificado para executar esta autenticação. Você não pode usar as credenciais de um usuário raiz da AWS ao definir RoleARN. A AWSAccessKey e AWSSecretKey devem ser de um usuário do IAM.

AWSRegion

A região de hospedagem do seu Amazon Web Services.

Valores Possíveis

OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEOUL, SINGAPORE, SYDNEY, TOKYO, CENTRAL, BEIJING, NINGXIA, FRANKFURT, IRELAND, LONDON, MILAN, PARIS, STOCKHOLM, BAHRAIN, SAOPAULO, GOVCLOUDEAST, GOVCLOUDWEST

Tipo de Dados

string

Valor Padrão

"NORTHERNVIRGINIA"

Observações

A região de hospedagem do seu Amazon Web Services. Os valores disponíveis são Ohio, NorthernVirginia, NorthernCalifornia, Oregon, Capetown, Hong Kong, Mumbai, Osaka, Seul, Cingapura, Sydney, Tóquio, Central, Pequim, Ningxia, Frankfurt, Ireland, Londres, Milan, Paris, Stockholm, Bahrain, SAUL, SALFURT, SALAND, SALAN, MILAN, GOLAN, PARIS, BAHRAIN, e GOVCLOUDWEST.

AWSCredentialsFile

O caminho para o arquivo de credenciais da AWS a ser usado para autenticação.

Tipo de Dados

string

Valor Padrão

""

Observações

O caminho para o arquivo de credenciais da AWS a ser usado para autenticação. Ver https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html para maiores informações.

AWSCredentialsFileProfile

O nome do perfil a ser usado do AWSCredentialsFile fornecido.

Tipo de Dados

string

Valor Padrão

"default"

Observações

O nome do perfil a ser usado do AWSCredentialsFile fornecido. Ver https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html para maiores informações.

AWSSessionToken

Seu token de sessão da AWS.

Tipo de Dados

string

Valor Padrão

""

Observações

Seu token de sessão da AWS. Esse valor pode ser recuperado de diferentes maneiras. Veja este link para mais informações.

AWSExternalId

Um identificador exclusivo que pode ser necessário quando você assume uma papel em outra conta.

Tipo de Dados

string

Valor Padrão

""

Observações

Um identificador exclusivo que pode ser necessário quando você assume uma papel em outra conta.

MFASerialNumber

O número de série do dispositivo MFA, se estiver sendo usado.

Tipo de Dados

string

Valor Padrão

""

Observações

Você pode encontrar o dispositivo de um usuário do IAM acessando o Management Console da AWS e visualizando as credenciais de segurança do usuário. Para dispositivos virtuais, na verdade, é um nome de recurso da Amazon (como arn:aws:iam:123456789012:mfa/user).

MFAToken

O token temporário disponível em seu dispositivo MFA.

Tipo de Dados

string

Valor Padrão

""

Observações

Se o MFA for necessário, esse valor será usado junto com o MFASerialNumber para recuperar credenciais temporárias para fazer login. As credenciais temporárias disponíveis na AWS duram apenas 1 hora por padrão (consulte TemporaryTokenDuration). Uma vez esgotado o tempo, a conexão deve ser atualizada para especificar um novo token MFA para que novas credenciais possam ser obtidas.

TemporaryTokenDuration

A quantidade de tempo (em segundos) que um token temporário durará.

Tipo de Dados

string

Valor Padrão

"3600"

Observações

Tokens temporários são usados com MFA e autenticação baseada em função. Os tokens temporários acabarão por expirar, momento em que um novo token temporário deve ser obtido. Para situações em que o MFA não é usado, isso não é grande coisa. O conector Jitterbit para Amazon DynamoDB solicitará internamente um novo token temporário assim que o token temporário expirar.

No entanto, para conexão MFA necessária, um novo MFAToken deve ser especificado na conexão para recuperar um novo token temporário. Este é um problema mais intrusivo, pois requer uma atualização da conexão por parte do usuário. O máximo e o mínimo que podem ser especificados dependerão muito da conexão que está sendo usada.

Para autenticação baseada em função, a duração mínima é de 900 segundos (15 minutos), enquanto a máxima é de 3600 (1 hora). Mesmo que o MFA seja usado com autenticação baseada em papel, 3600 ainda é o máximo.

Para autenticação MFA por si só (usando um usuário IAM ou usuário root), o mínimo é 900 segundos (15 minutos), o máximo é 129600 (36 horas).

AWSCognitoRegion

A região de hospedagem do AWS Cognito.

Valores Possíveis

OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEOUL, SINGAPORE, SYDNEY, TOKYO, CENTRAL, BEIJING, NINGXIA, FRANKFURT, IRELAND, LONDON, MILAN, PARIS, STOCKHOLM, BAHRAIN, SAOPAULO, GOVCLOUDEAST, GOVCLOUDWEST

Tipo de Dados

string

Valor Padrão

"NORTHERNVIRGINIA"

Observações

A região de hospedagem do AWS Cognito. Os valores disponíveis são Ohio, NorthernVirginia, NorthernCalifornia, Oregon, Capetown, Hong Kong, Mumbai, Osaka, Seul, Cingapura, Sydney, Tóquio, Central, Pequim, Ningxia, Frankfurt, Ireland, Londres, Milan, Paris, Stockholm, Bahrain, SAUL, SALFURT, SALAND, SALAN, MILAN, GOLAN, PARIS, BAHRAIN, e GOVCLOUDWEST.

AWSUserPoolId

A ID do grupo de usuários.

Tipo de Dados

string

Valor Padrão

""

Observações

Você pode encontrar isso em AWS Cognito -> Gerenciar grupos de usuários -> selecione seu grupo de usuários -> Configurações gerais -> Identificação do pool.

AWSUserPoolClientAppId

A ID do aplicativo do cliente do grupo de usuários.

Tipo de Dados

string

Valor Padrão

""

Observações

Você pode encontrar isso em AWS Cognito -> Gerenciar pools de identidades -> selecione seu grupo de usuários -> Configurações gerais -> Clientes de aplicativos -> ID do cliente do aplicativo.

AWSUserPoolClientAppSecret

Opcional. O segredo do aplicativo do cliente do grupo de usuários.

Tipo de Dados

string

Valor Padrão

""

Observações

Você pode encontrar isso em AWS Cognito -> Gerenciar pools de identidades -> selecione seu grupo de usuários -> Configurações gerais -> Clientes de aplicativos -> Segredo do cliente do aplicativo.

AWSIdentityPoolId

O ID do pool de identidades.

Tipo de Dados

string

Valor Padrão

""

Observações

Você pode encontrar isso em AWS Cognito -> Gerenciar pools de identidades -> selecione seu grupo de identidades -> Editar grupo de identidades -> ID do conjunto de identidades

SSO

Esta seção fornece uma lista completa de propriedades SSO que você pode configurar.

Do Utilizador

O usuário IDP usado para autenticar o IDP via SSO.

Tipo de Dados

string

Valor Padrão

""

Observações

Juntamente com Senha, esse campo é usado para autenticação em conexões SSO no servidor Amazon DynamoDB.

Senha

A senha usada para autenticar o usuário IDP via SSO.

Tipo de Dados

string

Valor Padrão

""

Observações

O usuário e Password são usados juntos em conexões SSO para autenticação com o servidor.

SSOLoginURL

A URL de login do provedor de identidade.

Tipo de Dados

string

Valor Padrão

""

Observações

A URL de login do provedor de identidade.

Propriedades SSO

Propriedades adicionais necessárias para se conectar ao provedor de identidade em uma lista separada por ponto e vírgula.

Tipo de Dados

string

Valor Padrão

""

Observações

Propriedades adicionais necessárias para se conectar ao provedor de identidade em uma lista separada por ponto e vírgula. SSOProperties é usado em conjunto com o AWSRoleARN e AWSPrincipalARN. A seção a seguir fornece um exemplo usando o provedor de identidade OKTA.

Autenticação com ADFS

Defina o AuthScheme para ADFS. As seguintes propriedades de conexão precisam ser definidas:

• Do utilizador: Defina isso para o usuário ADFS.
• Senha: Defina isso como a senha do ADFS para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.

Abaixo está um exemplo de string de conexão:

AuthScheme=ADFS; AWSRegion=Ireland; User=user@cdata.com; Password=CH8WerW121235647iCa6; SSOLoginURL='https://adfs.domain.com'; AWSRoleArn=arn:aws:iam:1234:role/ADFS_SSO; AWSPrincipalArn=arn:aws:iam:1234:saml-provider/ADFSProvider; S3StagingDirectory=s3://athena/staging;

ADFS Integrado

O fluxo integrado do ADFS indica que você está se conectando com o currently logged in Windows user credentials. Para usar o fluxo integrado do ADFS, simplesmente não especifique o Usuário e senha, caso contrário, siga as mesmas etapas no guia ADFS acima.

Autenticação com Okta

Defina o AuthScheme para Okta. As seguintes propriedades de conexão são usadas para se conectar ao Okta:

• Do utilizador: Defina isso para o usuário Okta.
• Senha: Defina isso como senha do Okta para o usuário.
• SSOLoginURL: Defina isso para a URL de login usada pelo provedor SSO.

A seguir SSOProperties são necessários para autenticar no Okta:

• APIToken (opcional): defina como o API Token que o cliente criou a partir da organização Okta. Ele deve ser usado ao autenticar um usuário por meio de um aplicativo ou proxy confiável que substitui o contexto de solicitação do cliente OKTA.
• MFAType (opcional): Defina isso apenas caso você tenha configurado o fluxo de MFA. Atualmente suportamos apenas os seguintes tipos: OktaVerify, E-mail e SMS.
• MFAPassCode (opcional): Defina isso apenas caso você tenha configurado o fluxo de MFA. Se estiver definido como vazio/inválido, o driver emitirá inicialmente um desafio de MFA que acionará a plataforma para enviar a você uma senha de uso único em seu dispositivo ou e-mail, com base no tipo de MFA configurado. Você precisa reemitir outra conexão em que o valor da senha única recuperada é passado para a propriedade de conexão MFAPassCode.

Veja a seguir um exemplo de string de conexão:

AuthScheme=Okta; AWSRegion=Ireland; User=user@cdata.com; Password=CH8WerW121235647iCa6; SSOLoginURL='https://cdata-us.okta.com/home/amazon_aws/0oa35m8arsAL5f5NrE6NdA356/272'; SSOProperties='ApiToken=01230GGG2ceAnm_tPAf4MhiMELXZ0L0N1pAYrO1VR-hGQSf;'; AWSRoleArn=arn:aws:iam:1234:role/Okta_SSO; AWSPrincipalARN=arn:aws:iam:1234:saml-provider/OktaProvider; S3StagingDirectory=s3://athena/staging;

SSOExchangeUrl

A URL usada para consumir a resposta SAML e trocá-la com credenciais específicas do Amazon DynamoDB.

Tipo de Dados

string

Valor Padrão

""

Observações

O conector Jitterbit para Amazon DynamoDB usará o URL especificado aqui para consumir uma resposta SAML e recuperar credenciais específicas do Amazon DynamoDB. As credenciais recuperadas são a peça final durante a conexão SSO usada para se comunicar com o Amazon DynamoDB.

SSL

Esta seção fornece uma lista completa de propriedades SSL que você pode configurar.

SSLServerCert

O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Tipo de Dados

string

Valor Padrão

""

Observações

Se estiver usando uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não seja confiável para a máquina é rejeitado.

Esta propriedade pode assumir as seguintes formas:

Se não for especificado, qualquer certificado confiável pela máquina será aceito.

Os certificados são validados como confiáveis pela máquina com base no armazenamento confiável do sistema. O armazenamento confiável usado é o valor 'javax.net.ssl.trustStore' especificado para o sistema. Se nenhum valor for especificado para esta propriedade, o armazenamento confiável padrão do Java será usado (por exemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar a aceitação de todos os certificados. Observe que isso não é recomendado devido a questões de segurança.

Esquema

Esta seção fornece uma lista completa de propriedades de esquema que você pode configurar.

Localização

Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.

Tipo de Dados

string

Valor Padrão

"%APPDATA%\\\AmazonDynamoDB Data Provider\\Schema"

Observações

O caminho para um diretório que contém os arquivos de esquema para o conector (arquivos .rsd para tabelas e exibições, arquivos .rsb para procedimentos armazenados). A localização da pasta pode ser um caminho relativo a partir da localização do executável. O Location a propriedade só é necessária se você quiser personalizar definições (por exemplo, alterar um nome de coluna, ignorar uma coluna e assim por diante) ou estender o modelo de dados com novas tabelas, exibições ou procedimentos armazenados.

Se não for especificado, o local padrão é "%APPDATA%\\AmazonDynamoDB Data Provider\Schema" com %APPDATA% sendo definido para o diretório de configuração do usuário:

Esquemas Navegáveis

Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar os esquemas de bancos de dados pode ser caro. Fornecer uma lista de esquemas na string de conexão melhora o desempenho.

Tabelas

Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tabelas=TabelaA,TabelaB,TabelaC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar as tabelas de alguns bancos de dados pode ser caro. Fornecer uma lista de tabelas na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitas para trabalhar.

Especifique as tabelas que deseja em uma lista separada por vírgulas. Cada tabela deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Visualizações

Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA,ViewB,ViewC.

Tipo de Dados

string

Valor Padrão

""

Observações

Listar as exibições de alguns bancos de dados pode ser caro. Fornecer uma lista de exibições na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.

Especifique as exibições desejadas em uma lista separada por vírgulas. Cada exibição deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Diversos

Esta seção fornece uma lista completa de diversas propriedades que você pode configurar.

AutoDetectIndex

Um booleano que indica se os índices secundários devem ser detectados automaticamente com base na consultar usada.

Tipo de Dados

bool

Valor Padrão

true

Observações

No DynamoDB, você pode usar índices secundários para selecionar dados mais rapidamente de uma determinada tabela. Por padrão, tentamos detectar automaticamente um índice a ser usado com base nos critérios de consultar. No entanto, isso nem sempre pode ser desejável. Para desativar a lógica de detecção de índice, defina a propriedade como false ou, se você tiver controle sobre a consultar e preferir especificar o índice por conta própria, use a pseudocoluna SecondaryIndexName para especificar qual índice usar (se houver).

FlattenArrays

Por padrão, arrays aninhados são retornados como strings de JSON. A propriedade FlattenArrays pode ser usada para nivelar os elementos de matrizes aninhadas em colunas próprias. Defina FlattenArrays para o número de elementos que você deseja retornar de matrizes aninhadas.

Tipo de Dados

string

Valor Padrão

""

Observações

Por padrão, arrays aninhados são retornados como strings de JSON. O FlattenArrays propriedade pode ser usada para nivelar os elementos de arrays aninhados em colunas próprias. Isso é recomendado apenas para arrays que devem ser curtos.

Definir FlattenArrays para o número de elementos que você deseja retornar de arrays aninhados. Os elementos especificados são retornados como colunas. O índice baseado em zero é concatenado ao nome da coluna. Outros elementos são ignorados.

Por exemplo, você pode retornar um número arbitrário de elementos de um array de strings:

["FLOW-MATIC","LISP","COBOL"]

Quando FlattenArrays é definido como 1, a matriz anterior é simplificada na tabela a seguir:

Flatten Objects

Defina FlattenObjects como true para nivelar as propriedades do objeto em colunas próprias. Caso contrário, os objetos aninhados em arrays são retornados como strings de JSON.

Tipo de Dados

bool

Valor Padrão

true

Observações

Definir FlattenObjects para true para achatar as propriedades do objeto em colunas próprias. Caso contrário, os objetos aninhados em arrays são retornados como strings de JSON. O nome da propriedade é concatenado no nome do objeto com um sublinhado para gerar o nome da coluna.

Por exemplo, você pode nivelar os objetos aninhados abaixo no momento da conexão:

[
     { "grade": "A", "score": 2 },
     { "grade": "A", "score": 6 },
     { "grade": "A", "score": 10 },
     { "grade": "A", "score": 9 },
     { "grade": "B", "score": 14 }
]

Quando FlattenObjects é definido como verdadeiro e FlattenArrays é definido como 1, a matriz anterior é simplificada na tabela a seguir:

Esquema Flexível

Defina FlexibleSchema como true para verificar metadados adicionais no conjunto de resultados da consultar. Caso contrário, os metadados permanecerão os mesmos.

Tipo de Dados

bool

Valor Padrão

true

Observações

Definir FlexibleSchema para true para verificar metadados adicionais no conjunto de resultados da consultar. Caso contrário, os metadados permanecerão os mesmos.

GenerateSchemaFiles

Indica a preferência do usuário quanto a quando os esquemas devem ser gerados e salvos.

Valores Possíveis

Never, OnUse, OnStart, OnCreate

Tipo de Dados

string

Valor Padrão

"Never"

Observações

Esta propriedade gera esquemas para arquivos .rsd no caminho especificado por Location.

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

• Nunca: Um arquivo de esquema nunca será gerado.
• OnUse: Um arquivo de esquema será gerado na primeira vez que uma tabela for referenciada, desde que o arquivo de esquema para a tabela ainda não exista.
• OnStart: Um arquivo de esquema será gerado no momento da conexão para todas as tabelas que atualmente não possuem um arquivo de esquema.
• OnCreate: Um arquivo de esquema será gerado ao executar uma consultar SQL CREATE TABLE.

Observe que, se você deseja gerar novamente um arquivo, primeiro precisará excluí-lo.

Gerar Esquemas com SQL

Ao definir GenerateSchemaFiles para OnUse, o conector gera esquemas conforme você executa consultas SELECT. Os esquemas são gerados para cada tabela referenciada na consultar.

Ao definir GenerateSchemaFiles para OnCreate, os esquemas são gerados apenas quando uma consultar CREATE TABLE é executada.

Gerar Esquemas na Conexão

Outra maneira de usar essa propriedade é obter esquemas para cada tabela em seu banco de dados quando você se conectar. Para isso, defina GenerateSchemaFiles para OnStart e conecte.

IgnorarTipos

Remove o suporte para os tipos especificados. Por exemplo, Tempo. Esses tipos serão relatados como strings.

Tipo de Dados

string

Valor Padrão

"Datetime,Date,Time"

Observações

Remove o suporte para os tipos especificados. Por exemplo, Tempo. Esses tipos serão relatados como strings.

MaximumRequestRetries

O número máximo de vezes para repetir uma solicitação.

Tipo de Dados

string

Valor Padrão

"4"

Observações

MaximumRequestRetries é o número máximo de vezes que o conector tentará novamente uma solicitação quando o problema for detectado como temporário (erros como "erro desconhecido", problemas de rede e exceder o limite máximo por tabela). Nesse caso, na primeira tentativa, o conector recuará e aguardará o tempo designado por RetryWaitTime. Se essa solicitação falhar, o conector dobrará o tempo e dobrará novamente até que o conector tenha esgotado as novas tentativas disponíveis.

Por exemplo, se RetryWaitTime está definido para 2 segundos e MaximumRequestRetries for definido como 5, os tempos de espera serão os seguintes: 0 -> 2 -> 4 -> 8 -> 16 -> 32.

MaxRows

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Tipo de Dados

int

Valor Padrão

-1

Observações

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Outro

Essas propriedades ocultas são usadas apenas em casos de uso específicos.

Tipo de Dados

string

Valor Padrão

""

Observações

As propriedades listadas abaixo estão disponíveis para casos de uso específicos. Os casos de uso e a funcionalidade normais do driver não devem exigir essas propriedades.

Especifique várias propriedades em uma lista separada por ponto e vírgula.

Integração e Formatação

Tamanho da Página

O número máximo de resultados a serem retornados por página do Amazon DynamoDB.

Tipo de Dados

int

Valor Padrão

2000

Observações

O Pagesize propriedade afeta o número máximo de resultados a serem retornados por página do Amazon DynamoDB. Por padrão esta propriedade possui o valor '-1' que indica que o provedor tentará obter todos os registros sem limite por página.

Pseudocolunas

Esta propriedade indica se deve ou não incluir pseudocolunas como colunas na tabela.

Tipo de Dados

string

Valor Padrão

""

Observações

Essa configuração é particularmente útil no Entity Framework, que não permite definir um valor para uma pseudocoluna, a menos que seja uma coluna de tabela. O valor dessa configuração de conexão está no formato "Table1=Column1, Table1=Column2, Table2=Column3". Você pode usar o caractere "*" para incluir todas as tabelas e todas as colunas; por exemplo, "*=*".

RetryWaitTime

O número mínimo de milissegundos que o provedor aguardará para tentar novamente uma solicitação.

Tipo de Dados

string

Valor Padrão

"2000"

Observações

O valor dessa propriedade é dobrado a cada nova tentativa para determinar quanto tempo esperar até a próxima tentativa. Especifique o número máximo de tentativas com MaximumRequestRetries.

RowScanDepth

O número máximo de linhas a serem verificadas para procurar as colunas disponíveis em uma tabela.

Tipo de Dados

int

Valor Padrão

50

Observações

As colunas em uma tabela devem ser determinadas pela varredura das linhas da tabela. Esse valor determina o número máximo de linhas que serão verificadas.

Definir um valor alto pode diminuir o desempenho. Definir um valor baixo pode impedir que o tipo de dados seja determinado corretamente, especialmente quando houver dados nulos.

Caractere Separador

O caractere ou caracteres usados para denotar hierarquia.

Tipo de Dados

string

Valor Padrão

"."

Observações

Para nivelar estruturas como mapas e atributos de lista no DynamoDB, precisamos de algum especificador que indique qual é a separação entre essas colunas e outras colunas. Se este valor for "." e uma coluna volta com o nome address.city, isso indica que existe um atributo mapeado com um filho chamado city. Se seus dados tiverem colunas que já usam um único ponto no nome do atributo, defina o SeparatorCharacter para um personagem ou personagens diferentes.

Contagem de Fios

O número de encadeamentos a serem usados ao selecionar dados por meio de uma varredura paralela. Definir ThreadCount como 1 desativará as verificações paralelas.

Tipo de Dados

string

Valor Padrão

"4"

Observações

As verificações paralelas permitem que os dados sejam recuperados mais rapidamente, dividindo o processo de recuperação em vários encadeamentos. Isso pode melhorar muito o desempenho ao verificar dados no Amazon DynamoDB. No entanto, isso também consumirá suas unidades de leitura para uma tabela muito mais rapidamente do que um único thread. Considere seus núcleos disponíveis, largura de banda e unidades de leitura para suas tabelas antes de aumentar o ThreadCount.

Tempo Esgotado

O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Tipo de Dados

int

Valor Padrão

60

Observações

Se Timeout = 0, as operações não expiram. As operações são executadas até serem concluídas com êxito ou até encontrarem uma condição de erro.

Se Timeout expira e a operação ainda não está concluída, o conector lança uma exceção.

TipoDetecçãoEsquema

Determina como determinar o tipo de dados das colunas.

Valores Possíveis

None, RowScan

Tipo de Dados

string

Valor Padrão

"RowScan"

Observações

UseBatchWriteItemOperation

Quando ativado, o provedor usará a operação BatchWriteItem para lidar com atualizações e inserções. Por padrão, o provedor usa a operação ExecuteStatement/BatchExecuteStatement. Você precisa habilitar BatchWriteItem somente ao inserir/atualizar dados binários/conjunto binário. ExecuteStatement/BatchExecuteStatement não oferece suporte à manipulação de campos binários.

Tipo de Dados

bool

Valor Padrão

false

Observações

Quando ativado, o provedor usará a operação BatchWriteItem para lidar com atualizações e inserções. Por padrão, o provedor usa a operação ExecuteStatement/BatchExecuteStatement. Você precisa habilitar BatchWriteItem somente ao inserir/atualizar dados binários/conjunto binário. ExecuteStatement/BatchExecuteStatement não oferece suporte à manipulação de campos binários.

UseConsistentReads

Sempre usar leituras consistentes ou não ao consultar o DynamoDb.

Tipo de Dados

bool

Valor Padrão

false

Observações

Este parâmetro não tem suporte em índices secundários globais. Se você varrer ou consultar usando um índice secundário, as leituras consistentes não serão usadas mesmo se a propriedade estiver definida como verdadeira.

UseSimpleNames

Booleano determinando se nomes simples devem ser usados para tabelas e colunas.

Tipo de Dados

bool

Valor Padrão

false

Observações

As tabelas e colunas do Amazon DynamoDB podem usar caracteres especiais em nomes que normalmente não são permitidos em bancos de dados padrão. UseSimpleNames torna o conector mais fácil de usar com ferramentas de banco de dados tradicionais.

Contexto UseSimpleNames para true simplificará os nomes das tabelas e colunas retornadas. Ele aplicará um esquema de nomenclatura de forma que apenas caracteres alfanuméricos e o sublinhado sejam válidos para os nomes de tabela e coluna exibidos. Quaisquer caracteres não alfanuméricos serão convertidos em um sublinhado.