HostBase

Integrations

Wrappers (FDW)

Query Stripe, Notion, S3 and more as Postgres tables.

This page is available in Polish only for now. The commands, code and API calls below are the same in every language — an English translation is on its way. Open the Polish page

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

TypWrappery
NatywneStripe, Airtable, Auth0, AWS Cognito, BigQuery, ClickHouse, DuckDB, DynamoDB, Firebase, Iceberg, Logflare, MySQL, SQL Server, Redis, S3, S3 Vectors
WebAssemblyCal.com, Calendly, Clerk, Cloudflare D1, Gravatar, HubSpot, Infura, Notion, OpenAPI, Orb, Paddle, Shopify, Slack, Snowflake

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).

PreviousIntegrationsNext Vault