Wyświetl kategorie

Integracja Anvil.works z DuckDB - automatyczna synchronizacja danych bazy danych na żywo

7 minut czytania

INTEGRACJA

DuckDB Kowadło

DuckDB DuckDB
Strumienie zapytań Strumienie zapytań
Kowadło Kowadło
Kod zerowy
Łatwa konfiguracja
Szybki

Query Streams umożliwia płynną integrację Anvil DuckDB, automatycznie synchronizując dane DuckDB na żywo z arkuszami Anvil. Zarejestruj się za darmo na QueryStreams.com i zacznij automatyzować przepływ danych z DuckDB do Anvil w ciągu kilku minut.

W tym przewodniku pokazano, jak skonfigurować automatyczną synchronizację danych z DuckDB do Anvil przy użyciu Query Streams. Niezależnie od tego, czy chcesz aktualizować arkusze zarządzania projektami na podstawie rekordów bazy danych, synchronizować dane dotyczące zapasów z obszarami roboczymi do współpracy, czy też zautomatyzować przepływy pracy związane z raportowaniem, Query Streams zapewnia bezpieczne, niewymagające kodowania rozwiązanie do integracji DuckDB z Anvil.works.

Zaplanowana automatyzacja

Synchronizacja co godzinę, codziennie lub według niestandardowych harmonogramów

Bezpieczeństwo przez projektowanie

Poświadczenia pozostają w Twojej sieci

Błyskawicznie

Zoptymalizowane przesyłanie danych

Inteligentna synchronizacja

Wstawianie, aktualizowanie, usuwanie automatycznie

Czym jest integracja Anvil DuckDB?

Integracja Anvil DuckDB łączy bazę danych DuckDB z Anvil, umożliwiając automatyczną synchronizację danych bez konieczności ręcznego eksportowania lub importowania. Query Streams działa jako bezpieczny pomost między bazą danych a Anvil, uruchamiając zapisane zapytania SQL zgodnie z harmonogramem i przesyłając wyniki bezpośrednio do arkuszy.

Kluczowe możliwości:

  • Automatyczna synchronizacja: Zaplanuj zapytania tak, aby były uruchamiane co godzinę, codziennie lub w niestandardowych odstępach czasu.
  • Tryb pełnej synchronizacji: Automatyczne wstawianie nowych wierszy, aktualizowanie istniejących wierszy i usuwanie skasowanych rekordów
  • Tryb dołączania: Dodawaj nowe rekordy bez modyfikowania istniejących danych (idealne rozwiązanie dla dzienników i historii)
  • Bezpieczne połączenie: Twoje dane uwierzytelniające do bazy danych pozostają chronione w ramach Twojej sieci.
  • Nie wymaga kodowania: Skonfiguruj wszystko za pośrednictwem portalu internetowego Query Streams.

Wymagania wstępne

1

Zainstalowany agent strumieni zapytań

Agent musi działać w Twojej sieci i mieć dostęp do bazy danych DuckDB.

Zainstaluj agenta Query Streams →
2

Skonfigurowane źródło danych DuckDB

Baza danych DuckDB powinna zostać dodana jako źródło danych w agencie.

Połącz DuckDB z Query Streams →
3

Konto Anvil

Konto Anvil z dostępem do API (dostępne w planach Business i Enterprise lub w ramach bezpłatnej wersji próbnej).

4

Zapisane zapytanie

Co najmniej jedno zapisane zapytanie w Query Streams, które zwraca dane, które chcesz zsynchronizować.

Krok 1: Utwórz zapytanie DuckDB

1
2
3
4
5
6
7

Przed skonfigurowaniem integracji należy zapisać zapytanie, które zwraca dane, które chcesz zsynchronizować z Anvil.

  1. Zaloguj się do portalu Query Streams: Odwiedź my.querystreams.com i zaloguj się
  2. Otwórz Kreator zapytań: Przejdź do Kreatora zapytań z pulpitu nawigacyjnego.
  3. Wybierz źródło danych DuckDB: W pasku bocznym Data Explorer po lewej stronie rozwiń obszar Data Realm, a następnie wybierz łącznik DuckDB i bazę danych, którą chcesz przeszukać.
  4. Napisz zapytanie SQL: Utwórz zapytanie, które zwraca dane, które chcesz zsynchronizować.
Przykład zapytania DuckDB SQL
SELECT 
    order_id,
    customer_name,
    order_date,
    total_amount,
    status
FROM orders
WHERE order_date >= NOW() - INTERVAL '30 days'
ORDER BY order_date DESC
LIMIT 1000;
  1. Testuj i oszczędzaj: Uruchom zapytanie, aby zweryfikować wyniki, a następnie zapisz je pod opisową nazwą, np. „Ostatnie zamówienia dla Anvil”.
Porada profesjonalisty: Jeśli planujesz używać trybu pełnej synchronizacji, upewnij się, że Twoje zapytanie zawiera kolumnę z unikalnym identyfikatorem (np. numer_zamówienia), które Anvil może wykorzystać do dopasowania wierszy.

Krok 2: Utwórz integrację Anvil.works

2
3
4
5
6
7

Teraz połączysz zapisane zapytanie z Anvil za pomocą funkcji automatyzacji.

  1. Przejdź do sekcji Automatyzacja: W portalu Query Streams kliknij Automatyzacja w lewym pasku bocznym
  2. Utwórz nową integrację: Kliknij Nowa integracja aby uruchomić kreatora konfiguracji
  3. Wybierz zapisane zapytanie: Wybierz zapytanie DuckDB utworzone w kroku 1.
  4. Wybierz Anvil jako miejsce docelowe: Wybierz Kowadło z listy dostępnych platform

Krok 3: Połącz swoje konto Anvil

3
4
5
6
7

Integracja z Anvil.works wymaga zainstalowania komponentu Query Streams w aplikacji Anvil.works i skonfigurowania go za pomocą bezpiecznego klucza połączenia.

1

Dodaj zależność od strony trzeciej

W aplikacji Anvil.works przejdź do Ustawienia → Zależności

Kliknij przycisk „Strona trzecia” zakładkę i wprowadź ten kod:

47C7VQG6QJTVY16B
2

Utwórz moduł serwera

W aplikacji Anvil.works utwórz plik Moduł serwera i dodaj ten kod:

z querystreams import connector
connector.init_connector("YOUR_AUTH_KEY")
3

Wygeneruj bezpieczny klucz uwierzytelniający

W konfiguracji automatyzacji strumieni zapytań:

  1. Kliknij Wygeneruj bezpieczny klucz (lub wprowadź własną)
  2. Skopiuj klucz autoryzacyjny
  3. Zastąp TWÓJ_KLUCZ_AUTORYZACYJNY w kodzie Anvil.works za pomocą tego klucza
4

Wprowadź adres URL aplikacji Anvil

W sekcji Query Streams (Strumienie zapytań) wprowadź opublikowany adres URL aplikacji Anvil.works (domena anvil.app lub Twoja domena niestandardowa).

Przykłady: https://your-app.anvil.app lub https://yourdomain.com

5

Połączenie testowe

Kliknij Połączenie testowe aby sprawdzić, czy Query Streams może komunikować się z aplikacją Anvil.works

Krok 4: Wybierz arkusz docelowy

4
5
6
7

Wybierz miejsce, w którym dane DuckDB będą synchronizowane w Anvil.works.

  1. Przeglądaj swoje arkusze: Query Streams wyświetli dostępne arkusze Anvil i obszary robocze.
  2. Wybierz arkusz: Wybierz istniejący arkusz, z którym chcesz zsynchronizować dane, lub wybierz Utwórz nowy arkusz
  3. Mapowanie kolumn: Query Streams automatycznie przypisze kolumny zapytania SQL do kolumn Anvil. Sprawdź i dostosuj w razie potrzeby.
Wskazówka: W przypadku tworzenia nowego arkusza Query Streams automatycznie utworzy kolumny na podstawie wyników zapytania.

Krok 5: Skonfiguruj tryb synchronizacji

5
6
7

Wybierz sposób, w jaki Query Streams ma obsługiwać synchronizację danych.

+

Tryb Append

Najlepsze dla logów i historii
  • Dodaje nowe wiersze na dole
  • Nigdy nie modyfikuje istniejących wierszy
  • Nigdy nie usuwa danych
  • Zachowuje historyczne zapisy
Idealny dla: Dzienniki audytowe, historia transakcji, śledzenie zdarzeń, dane szeregów czasowych

Tryb Full Sync

Popularne
Najlepsze rozwiązanie dla danych na żywo
  • Wkładki nowe rekordy
  • Aktualizacje zmienione rekordy
  • Usuwa usunięte rekordy
  • Wymaga kolumny kluczowej
Idealny dla: Zapasy, dane podstawowe, aktywne rekordy, pulpity nawigacyjne

Wybór kolumny kluczowej: W przypadku korzystania z trybu pełnej synchronizacji wybierz kolumnę, która jednoznacznie identyfikuje każdy wiersz. Kolumna ta musi występować zarówno w wynikach zapytania SQL, jak i w arkuszu Anvil.

Zachowanie synchronizacji kolumn (SYNC vs PRESERVE)

Dla każdej kolumny w mapowaniu pól wybierz sposób, w jaki Query Streams ma ją obsługiwać podczas synchronizacji:

SYNC (domyślnie)

Wartość źródłowa zawsze nadpisuje cel

Zastosowanie: Kolumny danych, które powinny dokładnie odpowiadać Twojej bazie danych (status zamówienia, sumy, daty)

ZACHOWAĆ

Wartość docelowa wynosi nigdy nie nadpisywane

Zastosowanie: Kolumny, w których dodajesz ręczne notatki, zadania lub aktualizacje statusu w Anvil.works
Przykład: Synchronizacja zamówień z notatkami zespołu
Kolumny źródłowe (z DuckDB)
  • numer_zamówienia – Pole kluczowe
  • nazwa_klienta – SYNC
  • status – SYNC
  • całkowity – SYNC
Kolumny dodane przez użytkownika (w Anvil.works)
  • Przypisane do – ZACHOWAĆ
  • Uwagi – ZACHOWAĆ
  • Priorytet – ZACHOWAĆ
Wynik: Każda synchronizacja aktualizuje dane zamówień z bazy danych, zachowując jednocześnie notatki i zadania Twojego zespołu.

Krok 6: Ustaw harmonogram synchronizacji

6
7

Skonfiguruj, kiedy Query Streams ma synchronizować dane z DuckDB do Anvil.

Instrukcja obsługi Synchronizuj tylko na żądanie
Co 5 minutSynchronizacja wysokiej częstotliwości dla danych w czasie rzeczywistym
Co 10 minutAktualizacje niemal w czasie rzeczywistym
Co 15 minutCzęsta synchronizacja aktywnych danych
🕑
Godzinowo Synchronizuj co godzinę
📅
CodziennieSynchronizuj raz dziennie o określonej godzinie
Niestandardowy Ustal konkretne dni i godziny

Krok 7: Sprawdź i aktywuj

7
  1. Konfiguracja recenzji: Sprawdź wszystkie ustawienia, w tym zapytanie, miejsce docelowe, tryb synchronizacji i harmonogram.
  2. Nazwij swoją integrację: Nadaj mu opisową nazwę, np. „Zamówienia do codziennej synchronizacji Anvil”.
  3. Aktywuj: Kliknij Utwórz integrację zapisać i aktywować
  4. Uruchom początkową synchronizację: Kliknij Uruchom teraz wykonanie pierwszej synchronizacji i sprawdzenie, czy wszystko działa poprawnie

Gratulacje!

Integracja DuckDB z Anvil.works została uruchomiona. Dane będą synchronizowane automatycznie zgodnie z harmonogramem.

Monitorowanie integracji

Po aktywacji możesz monitorować integrację Anvil DuckDB z poziomu pulpitu nawigacyjnego Automation:

🕑

Czas ostatniej synchronizacji

Zobacz, kiedy dane zostały ostatnio zsynchronizowane

📊

Zsynchronizowane wiersze

Wyświetl liczbę wstawionych, zaktualizowanych i usuniętych wierszy

🔔

Ostrzeżenia o błędach

Otrzymuj powiadomienia w przypadku niepowodzenia synchronizacji

📃

Historia synchronizacji

Przejrzyj poprzednie operacje synchronizacji i ich wyniki

Typowe przypadki użycia integracji Anvil DuckDB

💼

Zarządzanie projektami

Synchronizuj dane projektu, kamienie milowe i przydziały zasobów z bazy danych DuckDB do Anvil, aby zapewnić współpracę zespołu i przejrzystość.

💰

Proces sprzedaży

Aktualizuj informacje w Anvil dla swojego zespołu sprzedaży, dodając najnowsze możliwości, transakcje i dane klientów z bazy danych CRM.

📦

Śledzenie stanów magazynowych

Automatycznie aktualizuj poziomy zapasów, stany magazynowe i informacje o produktach w Anvil.works dla zespołów magazynowych i operacyjnych.

📈

Sprawozdawczość finansowa

Synchronizuj dane budżetowe, raporty wydatków i wskaźniki finansowe z Anvil w celu tworzenia pulpitów menedżerskich i raportów dla interesariuszy.

👥

HR i operacje

Synchronizuj wykazy pracowników, listy działów i dane organizacyjne między bazą danych HRIS a Anvil.

Często zadawane pytania

Jak często mogę synchronizować dane z DuckDB do Anvil? +

Query Streams obsługuje harmonogramy synchronizacji od co godzinę do niestandardowych interwałów. W większości przypadków synchronizacja codzienna lub co godzinę zapewnia dobrą równowagę między aktualnością danych a zasobami systemowymi.

🔒 Czy moje dane DuckDB są bezpieczne podczas synchronizacji? +

Tak. Twoje dane uwierzytelniające do bazy danych pozostają chronione w Twojej sieci dzięki agentowi Query Streams. Dane są szyfrowane podczas przesyłania, a token API Anvil jest bezpiecznie przechowywany. Query Streams nigdy nie przechowuje surowych danych z bazy danych.

Co się stanie, jeśli synchronizacja się nie powiedzie? +

Query Streams ponowi nieudane synchronizacje i powiadomi Cię o trwałych błędach. Możesz wyświetlić szczegóły błędu w historii synchronizacji i ręcznie uruchomić ponowną próbę po rozwiązaniu problemu.

📂 Czy mogę zsynchronizować wiele arkuszy Anvil z tą samą bazą danych DuckDB? +

Tak. Utwórz osobne integracje dla każdego arkusza docelowego. Każda integracja może korzystać z innego zapytania SQL, trybu synchronizacji i harmonogramu.

Czy to działa z usługami chmury DuckDB? +

Tak. Query Streams obsługuje wszystkie warianty DuckDB, w tym Amazon RDS dla DuckDB, Azure Database dla DuckDB, Google Cloud SQL dla DuckDB, Heroku duckdb oraz instancje hostowane samodzielnie.

Zaktualizowano na czerwiec 3, 2026

Powered by BetterDocs