Synchronizuj DuckDB z Anvil.works według harmonogramu

Automatyzacja · DuckDB do Anvil.works

Trzymać Kowadło.works zgodnie z plikiem DuckDB, zgodnie z harmonogramem

Napisz zapytanie SQL raz. Query Streams uruchamia je zgodnie z Twoim harmonogramem, od pięciu minut do cotygodniowych, i zapisuje wiersze do tabeli danych Anvil.works. Dopasuj wiersze według klucza, aby zmiany trafiły na swoje miejsce, a wiersze, które opuściły zapytanie, zostały usunięte, lub po prostu dopisz. Bez Zapiera, skryptów i eksportów. Za pierwszym razem zajmie to około piętnastu minut, a plan darmowy to obejmuje.

Około 15 minut Nie potrzeba kodowania Plik pozostaje tam, gdzie jest Co 5 minut lub co tydzień

Co z tego wyjdzie?

Tabela danych Anvil.works, która przechowuje wiersze zwracane przez zapytanie DuckDB i jest aktualizowana według harmonogramu, od pięciu minut do cotygodniowych aktualizacji, z potwierdzeniem zmian po każdym uruchomieniu. Na przykład:

Zamówienia dla Anvil.works Aktywny

Codzienna synchronizacja · 09:00 · Anvil.works 1643 wierszy · 8,8 sek.

1,627wiersze zsynchronizowanedopasowane według klucza · nic do zrobienia

11nowydołączone pod nagłówkami, te same kolumny

5zaktualizowanoceny zmienione w DuckDB, zaktualizowano 5 wierszy na miejscu

0REMOVEDwiersze opuszczające zapytanie są usuwane z tabeli danych

DuckDB holds your data in a file. Your team works in Anvil.works. The usual bridge is a hand-written import in your app that breaks quietly and copies one row at a time. Query Streams Automation does it differently: the Agent that already reads your DuckDB file runs your saved SQL on a schedule and writes the whole result into Anvil.works in one pass, matching rows by a key so the data table stays correct rather than growing.

Czego będziesz potrzebować

Konto Query Streams

Plan darmowy wystarczy do tego poradnika. Zarejestruj się na my.querystreams.com.

DuckDB połączony przez agenta

The Agent installed on the computer that holds your DuckDB file, or on one that reads it from a network share, with the connection added in Data Agents. Not done yet? Najpierw połącz DuckDB; zajmie to około dziesięciu minut.

Zapisane zapytanie

SELECT, który chcesz zachować w synchronizacji, zapisany w Kreator zapytańKrok 1 poniżej pokazuje jeden z nich. Jeśli chcesz, aby zmienione wiersze były aktualizowane na miejscu, dodaj kolumnę, która jest unikatowa dla każdego wiersza, np. identyfikator.

Twoje dane logowania do Anvil.works

Wprowadź adres HTTPS swojej aplikacji Anvil oraz klucz łącznika ustawiony w aplikacji za pomocą funkcji connector.init_connector("key") z modułu querystreams. Query Streams sprawdza odpowiedzi aplikacji i wyświetla listę jej tabel danych.

Skonfiguruj w sześciu krokach

1. Zapisz zapytanie, które chcesz zachować w synchronizacji

   Otwórz Kreator zapytań, wybierz połączenie DuckDB (jeszcze nie połączony? zacznij tutaj) i napisz instrukcję SELECT, która zwraca dokładnie te wiersze i kolumny, których potrzebujesz w Anvil.works. Ta instrukcja pobiera kilka kolumn z zamówienia tabela:

   Przykład · SQL

   WYBIERZ order_id, customer_name, order_total Z main.orders ZAMÓW WEDŁUG order_total OPIS LIMIT 100;

   Uruchom to, a potem Zapisz Nadaj mu nazwę, którą rozpoznasz, na przykład „Zamówienia dla Anvil.works”. Zachowaj kolumnę unikalną dla każdego wiersza w SELECT, tutaj. numer_zamówieniaTo jest klucz, którego używa Full Sync do aktualizacji wierszy w miejscu. Edytuj i ponownie zapisz zapytanie później, a automatyzacja wykryje zmianę przy następnym uruchomieniu.

2. Otwórz Automatyzację i wybierz Anvil.works

   W portalu otwórz Automatyzacja (górne menu Strumienie → Zaplanowane → Automatyzacja) i kliknij Nowa automatyzacja. Kreator ma pięć krótkich kroków. Na Krok 1 Kliknij Kowadło.works karta.

   Otwarta automatyzacja

   A może wolisz „Zanim zaczniesz”? Kreator otwiera się tylko wtedy, gdy agent jest online i ma połączenie oraz istnieje co najmniej jedno zapisane zapytanie. Strona zawiera listę brakujących zapytań i linki do nich.

3. Połącz Anvil.works

   NA Krok 2 strona przeprowadzi Cię przez stronę Anvil: dodaj kod zależności strumieni zapytań do swojej aplikacji w obszarze Ustawienia → Zależności → Strony trzecie, utwórz moduł serwera z z łącznika importu querystreams oraz connector.init_connector("twój klucz")i kliknij Wygeneruj bezpieczny klucz aby utworzyć ten klucz. Następnie wprowadź swój Adres URL aplikacji Anvil i to samo Klucz autoryzacji łącznika i kliknij Połączenie testowe. Twoja aplikacja potrzebuje Przyspieszone tabele włączone (Ustawienia → Tabele danych); strona sprawdza to ponownie.

4. Wybierz miejsce, w którym będą lądować rzędy

   NA Krok 3 wybierz Tabela danych Wiersze powinny trafić do tabeli. Najpierw utwórz ją w aplikacji Anvil, jeśli chcesz, aby była pusta. Jeśli zawiera już wiersze, podgląd je pokaże i wyjaśni, co każdy tryb synchronizacji z nimi zrobi. Jedna automatyzacja na tabelę.

5. Wybierz zapytanie i zdecyduj, jak mają trafić wiersze

   NA Krok 4 otwórz Zapisane zapytanie wyświetl listę i wybierz zapytanie z kroku 1. Query Streams uruchamia je raz, aby odczytać kolumny, informuje o liczbie zwróconych wierszy i pokazuje dwie opcje:

   Dołącz · szybko

   Dołącz

   Każde uruchomienie dodaje wiersze zapytania na dół tabeli danych. Nic nie jest aktualizowane ani usuwane, dlatego jest to szybki wybór w przypadku dzienników, zdarzeń i historii, które chcesz gromadzić. Nie jest potrzebna kolumna klucza. Wiersz, który powraca bez zmian, nie jest dodawany ponownie; wiersz, którego wartości uległy zmianie, jest dodawany poniżej jako nowy wiersz, a stary wiersz pozostaje.

   Pełna synchronizacja · lustra

   Pełna synchronizacja

   Wiersze są dopasowywane za pomocą klawisz kolumna, taka jak identyfikator zamówienia. Nowe wiersze są dodawane, zmienione wiersze są aktualizowane w miejscu, a wiersze, które nie są już zwracane przez zapytanie, są usuwane, w tym wiersze, które ktoś wprowadził ręcznie do tabeli danych, więc zachowaj ręcznie utworzone wiersze w innej tabeli danych. Jest to opcja dla zapasów, lejków, danych głównych i pulpitów nawigacyjnych.

   Pełna synchronizacja jest ustawiana dla każdej kolumny, co czyni ją użyteczną w przypadku współdzielonej tabeli danych:

   Klawisz

   Kolumna identyfikująca wiersz, na przykład numer_zamówieniaMusi być unikatowy w wyniku zapytania. Query Streams sprawdza to i odrzuca duplikaty.

   Synchronizacja

   Nadpisywane z DuckDB przy każdym uruchomieniu. Jeśli ktoś edytuje kolumnę Sync w Anvil.works, przy następnym uruchomieniu przywracana jest wartość źródłowa.

   Utrzymywać

   Zapisywana, gdy wiersz pojawia się po raz pierwszy i nigdy nie jest porównywana ponownie, więc zmiana w DuckDB nie powoduje aktualizacji. W przypadku notatek, właścicieli i dat kontynuacji, które Twój zespół wpisuje ręcznie, użyj kolumny, która w ogóle nie występuje w zapytaniu: kolumny istniejące tylko w Anvil.works nigdy nie są modyfikowane przez synchronizację.

   Co jest szybsze? Dołączanie zapisów nie wymaga wcześniejszego odczytu tabeli danych. Pełna synchronizacja odczytuje dane, porównuje każdy wiersz i zapisuje tylko różnice, więc trwa to dłużej, ale tabela danych zawsze pasuje do zapytania. Możesz później przełączyć się z panelu Edycja automatyzacji.

   Aby wybrać tabelę danych, której chcesz zaufać, kliknij Utwórz wszystkie kolumny jako synchronizowane, a następnie kliknij ikonę klucza na numer_zamówienia aby to zrobić KlawiszStrumienie zapytań skanują cały wynik, aby potwierdzić, że klucz jest unikatowy, i ostrzegają, jeśli tak nie jest. Przechowuj notatki zespołu w kolumnach, które nie są częścią zapytania; nigdy ich nie zmieniaj. Aby utworzyć dziennik, który powinien stale rosnąć, kliknij Utwórz wszystkie kolumny jako Zachowaj zamiast tego i pomiń klucz. Kliknij Kontynuować.

6. Ustaw harmonogram, nazwij go, utwórz

   NA Krok 5 wybierać Uruchom według harmonogramu i wybierz Częstotliwość:

   Częstotliwość	Biegi
   Co 5 minut	co 5 minut, najszybszy dozwolony
   Co 15 minut	co 15 minut
   Co 30 minut	co 30 minut
   Każda godzina	na szczycie każdej godziny
   Codziennie o 9 rano	codziennie o 9:00, domyślnie
   Codziennie o 6 rano	codziennie o 6:00
   Dni powszednie o 9 rano	Od poniedziałku do piątku o 9:00
   Tygodniowo (poniedziałek 9 rano)	w każdy poniedziałek o 9:00
   Niestandardowy harmonogram	własne minuty, godziny, dni tygodnia lub dni miesiąca

   Czasy podążają za Strefa czasowa którą wybierzesz, która zaczyna się od Twojej przeglądarki. Możesz również wybrać Tylko ręcznie i naciśnij Bieg Kiedy tylko chcesz; harmonogram można dodać później z panelu edycji automatyzacji. Zaplanowane uruchomienia odbywają się w Agencie, więc trwają nawet po zamknięciu przeglądarki. Jeśli komputer z Agentem jest wyłączony w momencie planowanego uruchomienia, pominięte uruchomienie nastąpi jednorazowo, wkrótce po ponownym uruchomieniu Agenta.

   Daj temu Nazwa integracji, takie jak „Zamówienia do Anvil.works, codziennie”, sprawdź Gotowy do stworzenia podsumowanie i kliknij Utwórz automatyzację. Wróć na stronę Automatyzacja i naciśnij Bieg Aby wykonać pierwszą synchronizację teraz, zamiast czekać na harmonogram, otwórz Anvil.works: wiersze są widoczne pod nagłówkami kolumn.

Co widzisz później

Ten Strona automatyzacji Wyświetla listę wszystkich automatyzacji wraz ze statusem, źródłem, celem, kluczem, harmonogramem, ostatnią synchronizacją i liczbą wierszy. Otwórz jeden dla Egzekucje Karta: każde uruchomienie z jego wyzwalaczem (ręcznym lub zaplanowanym), czasem trwania oraz wierszami utworzonymi, zaktualizowanymi, usuniętymi i niezmienionymi. Wydajność na karcie wyświetlane są przetworzone dane i wskaźnik sukcesu w okresie od 7 do 90 dni.

Co pozwalają plany

Automatyzacja jest dostępna w każdym planie, w tym w planie darmowym, bez limitu liczby tworzonych automatyzacji. Każdy plan ogranicza liczbę wierszy, jakie zapytanie może zwrócić w jednym przebiegu:

Jeśli zapytanie zwróci więcej, przebieg jest wstrzymywany, a nie przerywany, a automatyzacja wskazuje, który plan pasuje lub sugeruje dodanie filtra, takiego jak zakres dat. Każde pomyślne przebiegnięcie jest również wliczane do limitu Data Realm, tej samej puli, z której korzystają zapytania w Excelu i Arkuszach. Zobacz stronę z cennikiem za dodatki.

Dobre następne ruchy

• Dodaj filtr do zapytania, np. ostatnich 90 dni, dzięki czemu tabela danych pozostanie mała i szybka oraz będzie mieścić się w limicie wierszy Twojego planu.
• Przechowuj notatki wpisane ręcznie w osobnych kolumnach, poza zapytaniem, dzięki czemu przetrwają każdą synchronizację.
• Grupuj swoje automatyzacje z panelu Edycja, gdy masz ich kilka; strona Automatyzacja filtruje według grupy.

Reaching a file on a network share

The Agent opens files as a background service, not as you, so a file on another computer needs one extra step. Which step depends on the computer the Agent runs on.

If the test cannot get to the share, look for these words in its result: unreachable means the Agent’s computer got no answer from the server. On Linux or a Mac, not mounted means the share still has to be mounted, and that message includes the exact mount command for your server.

Test failed on a share?

Every run reaches the file the same way the connection test does. If runs start failing after something changed on the file server, a new password for example, open the connector in Agenci danych i kliknij Połączenie testowe. The test result, and the line under the file path, name the problem:

Pytania, które zadają ludzie

Powiązane przewodniki

• MySQL do Anvil.works
• PostgreSQL do Anvil.works
• Microsoft SQL Server do Anvil.works
• DuckDB do Arkuszy Google
• DuckDB do Airtable
• Jak połączyć DuckDB z Arkuszami Google
• Wszystkie przewodniki automatyzacji Anvil.works