문서 메뉴

Google Sheets#

Google OAuth와 선택한 스프레드시트 1개 이상을 사용해 Google Sheets에 연결합니다. 이 소스는 titan.google_sheets 아래에 표시되는 시트 탭마다 검색한 테이블 1개를 기록합니다.

Google Sheets 연결#

  1. 을 열고 앱 연결을 선택한 뒤 Google Sheets 항목을 선택합니다.

  2. Google OAuth와 선택한 스프레드시트 1개 이상을 입력합니다.

  3. 테이블을 확인한 뒤 소스를 저장합니다.

  4. 첫 실행이 완료될 때까지 동기화 기록을 확인합니다.

자격 증명은 비밀 정보로 저장됩니다. 레이크 열이 되거나 쿼리 결과에 나타나지 않습니다.

동기화 동작#

Supernova는 100행에서 타입을 추론하고, 병합된 셀을 앞의 값으로 채우며, 행 식별 정보를 명확히 유지하도록 _sn_row_number를 추가합니다.

새 소스는 연결할 때 동기화한 다음 설정된 일정을 따릅니다. 기본 반복 간격은 4시간입니다. 실행이 중단되어도 완료한 진행 상황을 유지하며 안전하게 재시도합니다.

모든 레이크 테이블에는 시스템 열_synced_at_deleted도 있습니다. 아래 열 참조에는 소스 열만 나열합니다.

테이블 참조#

Supernova는 연결된 계정에서 이 참조 정보를 검색합니다. 설정 후 스프레드시트 제목, 시트 탭, 헤더, 추론한 타입이 참조 정보를 정의합니다.

첫 스키마 검색 실행 후 앱 → Google Sheets → 테이블을 열면 모든 정확한 테이블 이름, 열 이름, 타입, 동기화 선택 항목을 볼 수 있습니다. 계정을 연결하기 전에는 동적 필드를 정확하게 나열할 수 없습니다.

삭제와 이력#

행은 소스 키로 병합됩니다. 소스에서 행 삭제를 입증할 수 있으면 Supernova는 행을 유지하고 _deleted를 설정합니다. 따라서 쿼리에서 이력을 포함할지 선택할 수 있습니다. 현재 상태를 조회하는 쿼리에는 where not _deleted 필터를 사용하세요.