---
title: Arkusze Google
description: Połącz Arkusze Google, poznaj sposób synchronizacji oraz odpytuj każdą zapisywaną tabelę i kolumnę.
species: reference
---
# Arkusze Google

Połącz Arkusze Google przez Google OAuth i wybierz co najmniej jeden arkusz kalkulacyjny. Źródło zapisuje po jednej wykrytej tabeli dla każdej widocznej karty arkusza w schemacie `titan.google_sheets`.
## Połącz Arkusze Google

1. Otwórz **Aplikacje**, wybierz **Połącz aplikację**, a następnie **Arkusze Google**.
2. Zaloguj się przez Google OAuth i wybierz co najmniej jeden arkusz kalkulacyjny.
3. Sprawdź tabele i zapisz źródło.
4. Obserwuj **Historię synchronizacji**, aż pierwsze uruchomienie się zakończy.

Dane uwierzytelniające są przechowywane jako sekrety. Nigdy nie stają się kolumnami jeziora ani nie pojawiają się w wynikach zapytań.

## Sposób synchronizacji

Supernova określa typy na podstawie 100 wierszy, uzupełnia scalone komórki wartością z poprzedniego wiersza i dodaje `_sn_row_number`, aby tożsamość wiersza była jednoznaczna.

Nowe źródło synchronizuje się po połączeniu, a następnie zgodnie z harmonogramem. Domyślny interwał cykliczny wynosi 4 godziny. Przerwane uruchomienie zachowuje ukończone postępy i jest bezpiecznie ponawiane.

Każda tabela jeziora ma też [kolumny systemowe](/docs/concepts/your-lake#kolumny-systemowe) `_synced_at` i `_deleted`; poniższa dokumentacja kolumn obejmuje wyłącznie kolumny źródłowe.

## Dokumentacja tabel

Supernova wykrywa tę strukturę na połączonym koncie. Po konfiguracji określają ją tytuły arkuszy kalkulacyjnych, nazwy kart, nagłówki i wywnioskowane typy.

Po pierwszym wykrywaniu otwórz **Aplikacje → Arkusze Google → Tabele**, aby zobaczyć dokładne nazwy tabel i kolumn, typy oraz wybór synchronizacji. Pól dynamicznych nie można rzetelnie wymienić przed połączeniem konta.

## Usunięcia i historia

Wiersze są scalane według klucza źródłowego. Gdy źródło może potwierdzić usunięcie wiersza, Supernova zachowuje go i ustawia `_deleted`, dzięki czemu zapytania mogą zdecydować, czy uwzględniać historię. Aby pobierać bieżący stan, filtruj zapytania przez `where not _deleted`.