Wrappery (Foreign Data Wrappers)

Wrappery (rozszerzenie wrappers 0.6.1) udostępniają dane zewnętrznych usług jako tabele obce. Odpytujesz je zwykłym SQL i łączysz z danymi aplikacji — bez pisania integracji i bez ETL.

Instalacja z panelu

1. Otwórz Integracje, wybierz wrapper (np. Stripe Wrapper) i kliknij Zainstaluj wrapper.
2. Podaj dane dostępowe — klucze API trafiają do Vault, a w definicji serwera zostaje tylko identyfikator sekretu.
3. Wybierz osobny schemat (domyślnie np. stripe) — nie jest on udostępniany przez Data API, więc dane zewnętrzne nie wyciekną publicznie.
4. Gdy wrapper to obsługuje, tabele zostaną zaimportowane automatycznie (IMPORT FOREIGN SCHEMA). W pozostałych przypadkach panel podpowie gotowy szablon CREATE FOREIGN TABLE.

Zakładka Wrappery pokazuje serwery, ich opcje (sekrety jako odwołania do Vault) i tabele obce z przyciskiem Testuj (select … limit 5). Usunięcie serwera usuwa też jego tabele obce i sekrety z Vault.

Dostępne wrappery

Wrappery Wasm są pobierane z oficjalnych wydań na GitHubie przy tworzeniu serwera i weryfikowane sumą kontrolną SHA-256. MongoDB wymaga nowszej wersji rozszerzenia i pojawi się po aktualizacji.

Przykład: Stripe ręcznie w SQL

create extension if not exists wrappers with schema extensions;
create foreign data wrapper stripe_wrapper
  handler extensions.stripe_fdw_handler validator extensions.stripe_fdw_validator;

select vault.create_secret('sk_live_…', 'stripe_key', 'Klucz Stripe') as key_id; -- zapamiętaj uuid

create server stripe_server foreign data wrapper stripe_wrapper
  options (api_key_id '<uuid z Vault>', api_url 'https://api.stripe.com/v1/');

create schema stripe;
import foreign schema stripe from server stripe_server into stripe;

select id, email, created from stripe.customers limit 10;

Wrappery wywołują zewnętrzne API przy każdym zapytaniu — dla raportów odpytuj je w cronie i zapisuj wyniki do zwykłych tabel (np. widok zmaterializowany).