> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Conexões de discovery

> Conecte o Matcher a bancos de dados externos e a APIs de adquirentes, teste cada conexão, navegue pelas tabelas que ela expõe e extraia registros para o Matcher.

A tela **Discovery** no módulo Matcher do Lerian Console gerencia as suas conexões de discovery. Uma conexão de discovery liga o Matcher a um banco de dados externo ou a uma API REST de adquirente. O Matcher lê as tabelas e as colunas da conexão. Uma extração então puxa registros das tabelas que você escolhe, e o Matcher faz a ingestão deles.

Para o workflow pela API, veja [Discovery](/pt/products/matcher/integrations/matcher-discovery).

## Acessando a página Discovery

***

Vá para **Configurações → Discovery**.

O cabeçalho da página tem dois botões:

* **Nova conexão** abre o painel para criar uma conexão.
* **Atualizar discovery** sincroniza de novo todas as conexões. Uma mensagem mostra o número de conexões sincronizadas.

Os chips acima da tabela mostram o número de conexões e a saúde do motor de extração.

## Tabela de conexões

***

| Coluna | Descrição |
| - | - |
| **Nome** | O nome da conexão |
| **Tipo** | O tipo de conector, como `POSTGRESQL` ou `STRIPE` |
| **Status** | **Available**, **Unreachable** ou **Unknown**. O resultado de um teste que você roda nesta página também aparece aqui |
| **Schema** | **Descoberto** quando o Matcher já leu as tabelas da conexão, ou **Pendente** |
| **Ações** | O menu de ações da conexão |

## Criando uma conexão

***

1. Clique em **Nova conexão**. O painel **Nova conexão** abre.
2. Digite o **Nome da conexão**.
3. Selecione o **Tipo de conector**. Os campos abaixo do seletor mudam conforme o tipo.
4. Preencha os campos do tipo.
5. Clique em **Salvar**.

### Tipos de conector de banco de dados

Os tipos de banco de dados são **PostgreSQL**, **MySQL**, **Oracle**, **SQL Server** e **MongoDB**.

| Campo | Descrição |
| - | - |
| **Host** | O nome do host ou o endereço do servidor de banco de dados |
| **Porta** | A porta do servidor de banco de dados |
| **Nome do banco de dados** | O nome do banco de dados |
| **Nome de usuário** | O usuário do banco de dados |
| **Senha** | A senha do usuário do banco de dados (opcional) |
| **Schema** | O schema no banco de dados (opcional) |

### Tipos de conector REST

Cada tipo REST mostra os próprios campos. Todos os tipos REST também mostram um campo opcional **URL base**, que define o endereço da API para esta conexão.

| Tipo de conector | Campos |
| - | - |
| `PAGBANK` | **ID do estabelecimento** e **Token EDI** |
| `STRIPE` | **Chave de API** |
| `PIX_BCB` | **Client ID**, **Client secret**, **Certificado do cliente (PEM)** e **Chave privada do cliente (PEM)** |

## Editando uma conexão

***

Abra o menu **Ações** de uma linha e clique em **Editar**. O painel **Editar conexão** abre.

* Para um tipo de banco de dados, você pode alterar o nome e os campos do banco de dados.
* Para um tipo REST, você pode alterar apenas o **Nome da conexão**. Para alterar outros valores, exclua a conexão e crie-a de novo.

Clique em **Salvar** para aplicar a alteração.

## Testando uma conexão

***

Abra o menu **Ações** de uma linha e clique em **Testar conexão**. A coluna **Status** mostra o resultado:

* **Conexão saudável** com o tempo de resposta em milissegundos.
* **Conexão falhou**, com o motivo quando o Matcher retorna um.

## Visualizando o schema

***

Abra o menu **Ações** de uma linha e clique em **Ver schema**. O painel **Schema da conexão** lista cada tabela da conexão. Para cada tabela, ele mostra os valores de **Coluna**, **Tipo** e **Aceita nulo**.

Se o painel mostrar **Nenhum schema descoberto ainda**, clique em **Atualizar discovery** quando a conexão estiver acessível.

O painel também pode mostrar estes marcadores:

| Marcador | Significado |
| - | - |
| **Último mapa conhecido** | A conexão está inacessível, ou as tabelas são uma versão arquivada. O painel mostra as tabelas que o Matcher leu por último, com a data da leitura |
| **Ainda não extraível** | O Matcher não tem colunas confirmadas para as tabelas. Você ainda não pode extrair dados delas. O alerta descreve as causas possíveis |
| **Colunas podem estar desatualizadas** | As colunas da tabela podem estar desatualizadas |
| **Menos colunas que na última leitura** | A última leitura retornou menos colunas para a tabela do que a leitura anterior |

A seção **Versões anteriores** lista as versões arquivadas do schema. Cada versão mostra a causa, a data de arquivamento e o número de tabelas. Clique em uma versão para ver as tabelas dela.

## Iniciando uma extração

***

1. Abra o menu **Ações** de uma linha e clique em **Iniciar extração**. O painel **Iniciar extração** abre.
2. Em **JSON de Tabelas**, digite um objeto JSON. Cada chave é um nome de tabela, exatamente como o schema o lista. Use `{}` como valor para extrair todas as colunas. Para extrair apenas algumas colunas, use `{"columns": ["id", "amount"]}`.
3. Clique em **Iniciar extração**.

O painel então mostra o status da extração, como **Extracting** ou **Complete**. Quando o Matcher envia os registros para a ingestão, o painel também mostra o **Job de ingestão**. Se a extração falhar, o painel mostra o erro.

Clique em **Executar em segundo plano** para fechar o painel enquanto a extração roda.

Uma fonte também pode puxar dados de uma conexão de discovery conforme um agendamento. Veja [Fontes do contexto](/pt/products/matcher/ui/context-sources).

## Excluindo uma conexão

***

Abra o menu **Ações** de uma linha e clique em **Excluir**. Na caixa de diálogo **Excluir conexão de discovery?**, clique em **Excluir conexão**. Leituras de schema e extrações que dependem da conexão podem parar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.