As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Integração com o Airtable
Com o conector de ação Airtable, você pode acessar a plataforma Airtable diretamente no Amazon Quick por meio de linguagem natural. Você pode criar e atualizar registros, gerenciar bases e tabelas, filtrar visualizações e realizar operações de dados relacionais sem sair do Amazon Quick.
O Amazon Quick oferece suporte a vários métodos de autenticação para o Airtable. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.
-
Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com sua conta Airtable.
-
Aplicativo OAuth personalizado — usa um aplicativo OAuth gerenciado pelo cliente registrado no Airtable. Essa opção dá à sua organização controle total sobre a configuração do OAuth.
-
Chave de API — usa um token de acesso pessoal Airtable para autenticação. Adequado para uso ou teste individual.
Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.
Antes de começar
Verifique se você tem o seguinte antes de configurar a integração.
-
Uma conta Airtable ativa com acesso às bases e dados que você deseja usar.
-
Para o aplicativo OAuth personalizado: Acesse o Airtable Builder Hub no site do Airtable
para registrar uma integração com o OAuth. -
Para chave de API: um token de acesso pessoal do Airtable Builder Hub
no site da Airtable. -
Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.
Configurando o Airtable
Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e prossiga para. Configurando o conector no Amazon Quick
Para autenticação personalizada do aplicativo OAuth ou da chave de API, conclua as etapas aplicáveis no Airtable antes de configurar o Amazon Quick.
Registrar uma integração OAuth (aplicativo OAuth personalizado)
Crie uma integração OAuth no Airtable Builder Hub para obter as credenciais de cliente que você precisa para o Amazon Quick.
-
Faça login no Airtable Builder Hub
no site da Airtable e escolha as integrações OAuth. -
Escolha Registrar nova integração OAuth.
-
Insira um nome para sua integração.
-
Para URLs de redirecionamento do OAuth, insira o URL de redirecionamento do Amazon Quick:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback -
Escolha Registrar integração.
-
Após o registro, gere um segredo do cliente escolhendo Regenerar segredo do cliente.
-
Registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.
-
ID do cliente
-
Segredo do cliente
-
-
Em Escopos, selecione as permissões que sua integração exige. Para obter a lista completa dos escopos recomendados, consulteEscopos recomendados.
Crie um token de acesso pessoal (chave de API)
Crie um token de acesso pessoal no Airtable Builder Hub para autenticação da chave de API.
-
Faça login no Airtable Builder Hub
no site da Airtable e escolha Tokens de acesso pessoal. -
Selecione Criar token.
-
Configure o nome do token, os escopos e o acesso básico conforme necessário para seu caso de uso.
-
Copie e armazene com segurança o token gerado. Você precisa dele ao configurar o Amazon Quick.
Escopos recomendados
Ao registrar uma integração OAuth ou criar um token de acesso pessoal, configure os escopos a seguir com base nas ações que você deseja usar.
| Escopo | Description |
|---|---|
data.records:read |
Leia os dados nos registros. |
data.records:write |
Crie, edite e exclua registros. |
data.recordComments:read |
Leia os comentários nos registros. |
data.recordComments:write |
Crie, edite e exclua comentários do registro. |
schema.bases:read |
Leia a estrutura das bases, incluindo nomes de tabelas e tipos de campos. |
schema.bases:write |
Edite a estrutura das bases, incluindo nomes de tabelas e tipos de campo. |
user.email:read |
Leia o endereço de e-mail do usuário autenticado. |
Configurando o conector no Amazon Quick
Conecte-se a partir da guia Disponível
Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, localize Airtable e escolha Connect.
-
Conclua o fluxo de login do Airtable e conceda as permissões solicitadas.
Para configurar um conector com o aplicativo OAuth personalizado ou a chave de API, use a guia Criar para sua equipe, conforme descrito abaixo.
Crie a partir da guia Criar para sua equipe
Depois de concluir qualquer configuração necessária do Airtable, crie o conector no Amazon Quick.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Encontre e escolha Airtable.
nota
Se um conector Airtable já existir, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
Para o aplicativo OAuth personalizado, configure os seguintes campos:
-
URL base (opcional) — A URL base da API Airtable. Exemplo:
https://api.airtable.com -
ID do cliente — O ID do cliente da sua integração com o Airtable OAuth.
-
Segredo do cliente — O segredo do cliente da sua integração com o Airtable OAuth.
-
URL do token — O endpoint do token. Exemplo:
https://airtable.com/oauth2/v1/token -
URL de autorização — O endpoint de autorização. Exemplo:
https://airtable.com/oauth2/v1/authorize -
URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.
-
-
Para a chave de API, configure os seguintes campos:
-
URL base (opcional) — A URL base da API Airtable. Exemplo:
https://api.airtable.com -
Chave de API — Seu token de acesso pessoal do Airtable.
-
E-mail (opcional) — O endereço de e-mail associado à sua conta Airtable.
-
-
-
Escolha Próximo.
-
Se você escolher o aplicativo OAuth padrão ou o aplicativo OAuth personalizado, uma janela de autorização do Airtable será aberta. Analise as permissões solicitadas, escolha as bases e os espaços de trabalho aos quais conceder acesso e escolha Conceder acesso.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.
-
Selecione Publish.
Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão disponíveis.
| Categoria | Ação | Description |
|---|---|---|
| Registros | Listar registros | Lista os registros em uma tabela com filtragem e classificação opcionais. |
| Registros | Obter registro | Recupera um registro específico por ID. |
| Registros | Registro de criação em lote | Cria um ou mais novos registros em uma tabela. |
| Registros | Atualizar registro | Atualiza campos em um registro existente. |
| Registros | Registro de atualização em lote | Atualiza vários registros em uma única operação usando PATCH. |
| Registros | Registro em Batch Put | Atualiza vários registros em uma única operação usando PUT. |
| Comentários | Listar comentários | Lista os comentários em um registro. |
| Comentários | Criar comentário | Adiciona um comentário a um registro. |
| Comentários | Atualizar comentário | Edita um comentário existente em um registro. |
| Schema | Bases da lista | Lista todas as bases acessíveis ao usuário autenticado. |
| Schema | Obtenha o esquema básico | Recupera o esquema de uma base, incluindo tabelas e definições de campo. |
| Schema | Criar tabela | Cria uma nova tabela em uma base. |
| Schema | Atualizar tabela | Atualiza as propriedades da tabela, como nome ou descrição. |
| Schema | Criar campo | Adiciona um novo campo a uma tabela. |
| Schema | Atualizar campo | Atualiza as propriedades do campo, como nome ou tipo. |
| Anexos | Criar anexo | Carrega um anexo em um registro. |
| Usuários | Obter informações do usuário | Recupera informações sobre o usuário autenticado. |
nota
As ações que você pode usar dependem das bases e dos espaços de trabalho acessíveis ao usuário autenticado.
Gerenciamento e solução de problemas
Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.
Problemas de autenticação
-
Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta do Airtable está ativa e se você pode entrar diretamente no airtable.com no site do Airtable
. Para o aplicativo OAuth personalizado, confirme se o URL de redirecionamento em sua integração com o Airtable OAuth corresponde ao URL de retorno de chamada do Amazon Quick. -
Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores em sua integração com o Airtable OAuth. Se você regenerou o segredo do cliente, atualize o valor no Amazon Quick.
-
Chave de API rejeitada — Verifique se seu token de acesso pessoal está ativo e tem os escopos necessários. Os tokens podem ser revogados ou expirados no Airtable Builder Hub.
-
Permissões insuficientes — Verifique se os escopos configurados para seu método de autenticação incluem as permissões necessárias para as ações que você deseja usar. Consulte Escopos recomendados.
