테이블

데이터를 담는 기본 단위입니다. 이 화면에서 테이블을 만들고, 데이터를 조회·입력·수정하고, 컬럼을 관리할 수 있습니다.

1. 테이블 목록

1. 왼쪽 사이드바에서 테이블을 엽니다.
2. 목록에서 이름·행 수·마지막 수정일을 확인하고, 테이블을 클릭하면 데이터 화면으로 이동합니다.
3. 상단의 새 Table 또는 Excel / CSV 업로드 버튼으로 새 테이블을 만듭니다.

이 화면에서 하는 정리 작업

• 드래그로 이동·정렬 — 행 왼쪽의 ⠿ 손잡이를 잡아 다른 그룹으로 끌어다 놓으면 그 그룹으로 옮겨지고, 같은 그룹 안에서 위아래로 끌면 순서가 바뀝니다. 빈 그룹에도 바로 떨어뜨릴 수 있습니다.
• 여러 개 한 번에 — 행 왼쪽 체크박스로 여러 테이블을 고르면 아래에 바가 뜹니다. 거기서 그룹으로 이동하거나 삭제할 수 있습니다.
• 끄는 동안 내용이 커서를 따라다녀 어디에 놓이는지 바로 보이고, 놓으면 그 자리로 정렬됩니다.
• 그룹 만들기·수정·삭제 — 오른쪽 위 새 그룹, 그룹 머리글의 ⋯ 메뉴(이름·색 수정, 그룹 삭제). 그룹을 지워도 안에 있던 테이블은 미분류로 남습니다.

2. 새 테이블 만들기

테이블 목록의 새 Table 버튼 또는 사이드바 "테이블" 타이틀 라인의 ＋ 버튼을 누르면 만들 방법을 고르는 팝업이 열립니다.

1. 빈 Table 만들기 — 이름과 컬럼(이름·타입)을 팝업에서 바로 정하고 시작합니다. API 이름(영문 식별자)은 제목에서 AI 가 자동 생성합니다 — 예: "배송상태" → delivery_status (나중에 변경 가능).
2. Excel / CSV 업로드 — 파일 헤더로 컬럼을 자동 추론해 확정한 뒤 데이터를 가져옵니다.
3. 구글 Sheet 로부터 만들기 — "링크가 있는 모든 사용자(뷰어)"로 공유된 구글 시트 주소를 붙여 넣으면 같은 방식으로 가져옵니다. 주소에 특정 탭(gid=…)이 있으면 그 탭을 가져오고, 시트 제목이 테이블 이름으로 자동 제안됩니다. 여러 줄로 쓴 헤더는 한 줄 컬럼명으로 정리되고, 헤더도 값도 없는 빈 열은 기본으로 제외됩니다(체크박스로 되살릴 수 있음). O/X·Y/N·TRUE/FALSE 처럼 불리언 표기만 있는 열은 참/거짓(토글) 으로, 자유 서술(비고류) 열은 짧은 값이 반복되지 않는 한 텍스트로 추론됩니다.

사이드바의 그룹 타이틀 라인에 마우스를 올리면 ＋ 버튼이 나타나며, 여기로 만들면 새 테이블이 그 그룹 소속으로 바로 생성됩니다.

3. 데이터 조회와 편집 (Data 탭)

테이블을 열면 Data 탭이 기본으로 열립니다.

1. 검색 — 상단 검색창은 텍스트 컬럼 전체를 대상으로 검색합니다. 참/거짓(BOOLEAN) 컬럼은 셀에 on/off 토글로 표시되고, 클릭 한 번으로 켜고 끕니다.
2. 정렬·필터 — 컬럼 머리글을 클릭하면 정렬, 옆의 필터 버튼으로 컬럼별 조건 필터를 겁니다. 적용된 정렬·필터는 상단에 칩으로 표시되고 각각 X 로 개별 해제하거나, 초기화 버튼으로 한 번에 지울 수 있습니다. 정렬은 테이블마다 기억되어 다음에 그 테이블을 열면 마지막 정렬로 보입니다(정렬을 해제한 상태도 그대로 기억합니다). 주소(URL)에 정렬이 지정된 링크로 들어오면 그 정렬이 우선합니다.
3. 편집 — 셀을 클릭해 값을 바로 수정합니다. 행 hover 액션의 ＋(아래에 행 추가) 는 빈 행을 즉시 만들고 첫 칸에 커서를 둡니다 — 바로 타이핑해 Enter/Tab = 다음 항목으로 이동, Ctrl+Enter = 저장하고 편집 종료(바깥 클릭과 동일)로 채우세요. 셀 안에서 Alt+Enter 를 누르면 엑셀처럼 줄이 바뀌고, 편집 박스가 내용만큼 아래로 늘어납니다(한글 입력 중 Enter 는 글자 조합을 끝낼 뿐이라 한 번 더 눌러야 다음 칸으로 갑니다). 저장한 뒤에는 줄바꿈이 그대로 보이며 행 높이가 허용하는 만큼(기본 두 줄) 표시되고, 더 길면 말줄임으로 접힌 뒤 마우스를 올리면 전체 내용이 뜹니다. 더 보고 싶으면 아래 6번의 행높이를 키우세요. 마지막 칸에서 Enter/Tab 을 치면 새 줄이 자동으로 추가되고, 새 줄을 빈 채로 떠나면 자동으로 정리됩니다. 필수 컬럼이 있는 테이블은 저장 대기 행(왼쪽 초록 표시)으로 먼저 생기고, 필수 값이 모두 채워지는 순간 자동 저장됩니다. 상단 행 추가 버튼은 입력 창으로 한 번에 여러 값을 넣을 때 씁니다. 툴바의 작업 버튼에 실행 · 엑셀 내려받기 · 삭제 · 테이블 비우기가 모여 있습니다 — 행을 체크했으면 체크한 행만, 체크가 없으면 지금 걸린 필터·검색에 맞는 행 전체가 대상입니다(메뉴 맨 위에 무엇에 적용되는지 표시). 엑셀 내려받기는 Import / Export 탭까지 가지 않아도 됩니다. 테이블 비우기만은 선택·필터와 무관하게 행 전체를 지웁니다(아래 3-1 참고). 앱이 연결된 테이블이면 같은 메뉴에 연결된 앱 설정으로 이동이 함께 나옵니다(테이블 목록·사이드바의 App 뱃지를 눌러도 같은 화면으로 갑니다). 저장 대기 행에서 필수 값을 비운 채 다른 곳을 클릭하면 어떤 필수 값이 비었는지 토스트로 알려 줍니다. 새 행은 맨 아래에 추가됩니다. 행에 마우스를 올리면 오른쪽 끝에 액션 버튼 3개(아래에 행 추가 · 행 복제 · 행 삭제)가 바로 나타납니다. 행 ID 는 No 숫자를 클릭하면 복사됩니다. 컬럼은 머리글 오른쪽 끝의 ＋ 컬럼 추가로 바로 만들 수 있습니다(이름·타입만 — 세부 설정은 Columns 탭).
4. 드래그로 순서 바꾸기 — 컬럼은 머리글 이름을 잡아 좌우로, 행은 행 맨 앞의 ⠿ 손잡이(드래그 전용)를 잡아 위아래로 끌어 옮깁니다. 끄는 동안 실제 컬럼/행이 밀려나며 자리가 보입니다. 행 순서 이동은 정렬·필터·검색이 걸려 있지 않을 때만 가능하며, 걸려 있으면 안내가 뜹니다(순서는 팀 전체에 같이 적용).
5. 테이블 크기 조절 — 그리드 카드 맨 아래 가로 손잡이로 높이, 오른쪽 세로 손잡이로 너비를 드래그해 조절합니다. 놓는 순간 저장되어 다음에도 유지됩니다(내 계정 개인 설정, 테이블별 저장).
6. 글자 크기·행 높이 — 그리드 아래 상태바 오른쪽에서 글자(1122px)와 행높이(28120px)를 각각 −/＋ 로 조절합니다. 테이블마다 따로 저장되고 계정에 남아 다른 기기에서도 그대로입니다. 행 높이를 키우면 줄바꿈이 있는 값이 그만큼 더 여러 줄 보입니다(넘치는 줄은 말줄임 + 마우스를 올리면 전체 내용).
7. No 컬럼 = 행 번호 — 테이블마다 1번부터 붙는 고유 번호입니다. 정렬·검색·행 삭제로 바뀌지 않고, 지운 번호는 다시 쓰지 않습니다. 작업 이력도 같은 번호로 행을 가리키므로 "값 수정 #12" 는 No 12 행을 고쳤다는 뜻입니다. 번호를 클릭하면 API 에서 이 행을 가리키는 ID 가 복사됩니다(개발자용 — 마우스를 올리면 전체 ID 표시).
8. 행은 100행 단위로 불러오며, 스크롤을 내리면 자동으로 이어서 불러옵니다.
9. 작업 이력 — 그리드 아래에서 누가 언제 무엇을 했는지 최신순으로 봅니다(행 등록·값 수정·삭제·이동, 컬럼 추가·수정·삭제·순서 변경, 테이블 생성·수정·삭제·비우기).
   • 한 건이 한 줄입니다. 작업 종류는 색 배지(등록 초록 · 수정 파랑 · 삭제 빨강 · 구조 변경 보라), 바뀐 값은 이전 값이 빨간 취소선, 새 값이 초록 강조로 보입니다.
   • 행은 번호(#12) 로 가리키고, 옆에 첫 컬럼 값을 같이 보여 줍니다(예: #12 고객명 김영희). 삭제된 행도 그때의 값으로 표시됩니다.
   • 목록 / 표 두 가지로 볼 수 있습니다. 표는 시각·작업자·작업·행·컬럼·이전·이후 열이고, 한 번에 여러 컬럼을 고쳤으면 컬럼마다 한 줄로 펼쳐집니다.
   • 숨김 권한(HIDDEN)인 컬럼의 변경은 보이지 않습니다. 공유 링크의 익명 수정은 "익명(공유 링크)"으로 표시됩니다.
   • 그리드에서 값을 고치거나 행을 넣고 지우면 이력이 곧바로 갱신됩니다(새로고침 없이).
   • 기본은 최근 10줄 정도이고 전체보기로 펼칩니다. 작업자 드롭다운과 내용 검색으로 좁혀 볼 수 있습니다. 오른쪽 위 패널 아이콘으로 이력을 테이블 오른쪽에 나란히 둘 수 있습니다(브라우저별로 기억).

필터·정렬·검색어는 주소(URL)에 실리므로 새로고침해도 같은 화면이 유지되고, 링크를 공유하면 같은 조회 조건이 재현됩니다.

3-1. 테이블 비우기 — 내용 전체 삭제

테이블은 그대로 두고 저장된 행만 전부 지웁니다. 테스트 데이터를 털어내고 처음부터 다시 넣을 때 씁니다.

1. Data 탭 툴바의 작업 → 맨 아래 테이블 비우기를 누릅니다.
2. 확인 창에 지워질 행 수가 표시됩니다. 테이블 이름을 그대로 입력해야 버튼이 활성화됩니다(실수 방지).
3. 테이블 비우기를 누르면 행이 모두 사라지고, 몇 행을 지웠는지 알림으로 보여 줍니다.

• 선택·필터를 보지 않습니다. 체크한 행이나 필터 결과만 지우려면 같은 메뉴의 삭제를 쓰세요.
• 되돌릴 수 없습니다. 필요한 데이터는 먼저 엑셀 내려받기로 받아 두세요.
• 컬럼·컬럼 설정·공유 링크·연결된 앱·자동화는 그대로 남습니다. API 로 조회하면 빈 목록이 됩니다.
• 행 번호(No)는 이어서 붙습니다 — 비운 뒤 새로 넣는 행은 1번이 아니라 그다음 번호를 받습니다(번호를 다시 쓰지 않는 규칙).
• 작업 이력에는 "테이블 비우기 · N행 삭제" 한 줄로 남습니다(행마다 한 줄씩 쌓이지 않습니다).
• 편집 권한이 있는 사람만 쓸 수 있고, 조회 전용 멤버와 공유 링크 화면에는 항목 자체가 보이지 않습니다.

4. 컬럼 관리 (Columns 탭)

1. Columns 탭을 엽니다. 컬럼마다 표시명·API 이름·타입·필수·유니크를 관리합니다. 필수·유니크는 컬럼 이름 옆에 뱃지로 표시됩니다(Data 탭 머리글에서는 빨간 *(필수) 와 열쇠 아이콘(유니크)).

2. 컬럼 행을 드래그해서 순서를 바꿉니다. 각 행 오른쪽에 컬럼추가(이 컬럼 아래에 새 컬럼) · 컬럼수정 · 삭제 버튼이 있고, 행을 클릭해도 수정 화면이 열립니다. 컬럼명(표시명)을 바꿔도 데이터는 안전합니다.

3. 오른쪽 컬럼 추가 폼에서 표시명·타입·필수·유니크·기본값을 정해 새 컬럼을 추가합니다. API 이름은 표시명에서 자동 제안됩니다.

4. 컬럼 순서는 드래그로 바꿉니다(끄는 컬럼이 커서를 따라옵니다). 나에게 숨겨진 컬럼이 있어도 보이는 컬럼끼리 순서를 바꿀 수 있고, 숨겨진 컬럼은 원래 자리를 지킵니다.

5. 필수·유니크를 켤 때는 이미 저장된 데이터를 먼저 확인합니다.

   • 유니크 — 같은 값을 가진 행이 이미 있으면 켜지지 않고 안내가 뜹니다. 중복을 정리한 뒤 다시 시도하세요.
   • 필수 — 값이 비어 있는 행이 몇 개인지 알려 주고 확인을 받습니다. 그대로 진행하면 기존 행은 건드리지 않고, 앞으로 저장할 때부터 값을 요구합니다.

6. 유니크 — 컬럼 폼에서 유니크를 켜면 컬럼 목록이 순서대로 나오고 지금 컬럼은 기본 선택돼 있습니다. 그대로 저장하면 이 컬럼 값만으로 중복을 막는 단독 유니크이고, 다른 컬럼을 더 고르면 조합 유니크로 처리됩니다(안내 문구가 뜹니다 — 예: 사이트 + 상품번호). 조합에서는 조합 값이 같은 행만 막고 각 컬럼 자체는 겹쳐도 되며, 어느 한 컬럼이 비어 있는 행은 검사하지 않습니다. 고른 컬럼 모두에 조합이 걸려 목록에 유니크 조합 뱃지가 붙고, 어느 컬럼을 열어도 같은 조합이 보입니다. 기존 행에 같은 값(조합)이 있으면 켜지지 않으니 중복을 먼저 정리하세요. 유니크를 끄거나 컬럼을 지우면 조합도 사라집니다. API 에서는 이 조합으로 keyColumns upsert 를 할 수 있습니다(테이블 API 탭 참고).

컬럼 정의는 단일 진실입니다 — 여기서 바꾸면 데이터 그리드, 엑셀 업로드 양식, API 문서, 검색 조건에 전부 자동 반영됩니다.

주의

• API 이름 변경은 신중하게 — 바꾸면 이전 이름은 즉시 사용할 수 없게 됩니다. 이 테이블 API 를 연동 중인 시스템이 있는지 먼저 확인하세요.
• Import·Export, API 예제, 자동화, 외부 공유는 테이블 상단 탭에서 이어집니다 — Import (엑셀 업로드), 앱, 자동화 문서를 참고하세요.

이 테이블에 공동작업자 초대하기

특정 사람에게 이 테이블만 열어 주려면 공유 링크 대신 공동작업자 초대를 씁니다. 초대받은 사람은 계정으로 로그인하므로 수정 내역이 실명으로 남습니다.

1. 테이블 상세 우상단의 초대 버튼을 누릅니다 (관리 권한 필요).
2. 이메일을 입력하고 권한(보기 / 편집 / 관리)을 고른 뒤 초대를 누르면 초대 링크가 발급됩니다. 이메일을 지정하면 초대 메일이 자동으로 발송되고 그 계정만 수락할 수 있습니다. 이메일을 비우면 링크만 발급되니 복사해 직접 전달하세요. (메일 발송에 실패해도 초대는 유효합니다 — 링크를 복사해 전달하면 됩니다.)
3. 상대가 가입(또는 로그인)하고 수락하면, 워크스페이스의 공동작업자로 참여하며 선택한 권한이 자동으로 부여됩니다. 공동작업자에게는 초대받은 테이블만 보입니다.
4. 같은 다이얼로그에서 이 테이블에 접근하는 사람들의 권한을 바꾸거나 회수할 수 있고, 아래 전체 멤버 관리로 워크스페이스 전체 명부로 이동할 수 있습니다.

공동작업 테이블 — 초대받은 테이블 보기

다른 워크스페이스에서 나를 공동작업자로 초대하면, 그 테이블은 내 테이블 목록이 아니라 사이드바의 공동작업 테이블 메뉴에 모입니다 (내가 만든 테이블과 섞이지 않습니다).

• 초대로 가입해도 내 워크스페이스는 따로 생깁니다 — "테이블" 메뉴에서 내 테이블을 자유롭게 만들 수 있습니다.
• 공동작업 테이블 화면은 초대받은 워크스페이스별로 카드가 나뉘고, 내가 권한을 받은 테이블만 보입니다. 클릭하면 바로 그 테이블의 Data 화면이 열립니다.
• 어떤 권한(보기/편집/관리)으로 참여 중인지는 해당 워크스페이스 관리자가 정합니다.

테이블을 외부에 공유하기

로그인하지 않은 외부 상대(거래처·고객)에게 테이블을 보여주려면 공유 링크를 만듭니다. 테이블 상세의 공유 탭에서 관리합니다.

1. 공유 링크 만들기를 누르면 링크가 생기고 설정 패널이 열립니다. 링크마다 세 가지를 정합니다:
   • 접속 — 누구나(링크만으로) 또는 비밀번호 입력 후
   • 권한 — 보기 전용, 수정 가능(셀 값 수정 · 이력은 익명으로 남음), 또는 입력 폼(아래 "입력 폼으로 접수받기")
   • 보이는 범위 — 이 링크에서만 숨길 컬럼을 체크 해제 (예: 단가). 멤버 권한과는 무관합니다.
2. 링크 이름(예: "A거래처용")과 만료일(무기한/7일/30일)도 정할 수 있습니다. 만료가 지나면 링크는 열리지 않습니다.
3. 회수는 두 가지 — 링크 회수(주소 유지, 즉시 무효) 또는 주소 재발급(옛 주소 폐기). 같은 테이블에 용도별 링크를 여러 개 만들어 따로 회수할 수 있습니다.

비밀번호를 설정한 링크는 여는 사람에게 먼저 비밀번호를 묻습니다:

입력 폼으로 접수받기

주문·신청·설문처럼 기존 데이터는 보여 주지 않고 새 행만 받고 싶을 때 공유 링크의 권한을 입력 폼으로 정합니다.

1. 공유 링크의 설정에서 권한을 입력 폼으로 고르고 저장합니다. 링크에 "입력 폼" 배지가 붙습니다.
2. 보이는 범위에서 체크를 해제한 컬럼(예: 처리상태·내부 메모)은 양식에 나오지 않고, 제출로도 값을 넣을 수 없습니다.

3. 링크를 연 사람은 컬럼 정의대로 만들어진 양식만 봅니다 — 기존 행은 화면에도 API 로도 볼 수 없습니다. 필수 컬럼에는 "필수" 표시가 붙고, 선택 목록 컬럼은 고르는 칸으로 나옵니다.
4. 제출하기를 누르면 테이블에 행이 하나 추가되고, 제출한 사람에게는 접수 번호(행 번호)만 보입니다. 필수 항목이 비었거나 값 형식이 틀리면 해당 항목을 알려 주고 저장하지 않습니다.

• 로그인한 멤버가 폼 링크를 열어도 같은 양식이 보이고, 제출은 링크로 들어온 입력으로 기록됩니다.
• 같은 사람(IP)이 짧은 시간에 너무 많이 제출하면 잠시 막힙니다(분당 30회). 비밀번호·만료일·링크 회수는 다른 공유 링크와 똑같이 씁니다.
• 제출된 행도 플랜의 저장 행 수에 포함됩니다. 한도를 넘으면 제출 화면에 "지금은 접수할 수 없습니다"가 보입니다.

테이블 그룹으로 정리하기

관련 테이블을 그룹으로 묶어 목록과 사이드바에서 한 덩어리로 볼 수 있습니다. (예: 한 앱이 쓰는 입력/출력 테이블)

1. 테이블 목록 또는 사이드바 "테이블" 타이틀 라인의 그룹 추가 버튼으로 그룹을 만듭니다 (이름·색 지정, 미분류 테이블을 골라 함께 넣을 수 있습니다).
2. 각 테이블 행의 ⋯ 버튼 → 그룹으로 이동으로 소속을 바꿉니다. 테이블은 한 번에 한 그룹에만 속합니다. 같은 메뉴 맨 아래 또는 테이블 상세 화면 오른쪽 위의 ⋯ 메뉴에서 테이블 삭제로 테이블을 지울 수 있습니다(확인 창에 이름·행 수가 표시되며, 삭제하면 목록과 API 에서 사라집니다). 활성 공유 링크가 있는 테이블은 링크 아이콘, 공동작업자가 있는 테이블은 사람 아이콘이 이름 옆에 표시됩니다(목록·사이드바 공통). 사이드바 테이블 행에서도 hover ⋯ 메뉴로 삭제할 수 있습니다.
3. 사이드바에서는 그룹 머리글을 눌러 접고 펼 수 있고(내 계정에만 적용, 다른 기기에서도 유지), 그룹이나 테이블 행을 그대로 잡아 드래그하면 순서가 바뀝니다 — 순서는 팀 전체에 같이 적용됩니다. 그룹에 속한 테이블은 그룹 색의 세로 선 안에 들여쓰여 표시됩니다.
4. 사이드바 그룹 머리글에 마우스를 올리면 ⋯ 메뉴가 나타나 이름·색 변경과 삭제를 바로 할 수 있습니다. 그룹을 삭제해도 테이블은 지워지지 않고 미분류로 돌아갑니다.