연결 범위

연동은 연결한 데이터베이스만 읽고 쓸 수 있습니다. 연결은 데이터베이스 하나씩 합니다. 스페이스 전체를 한 번에 연결할 수는 없습니다.

데이터베이스 연결하기

두 곳에서 연결할 수 있습니다.

연동 상세: 연결된 데이터베이스 → 데이터베이스 추가
데이터베이스 메뉴: ⋯ → API 연동

작업	할 수 있는 사람
연동 만들기 · 토큰 · 권한 · 지우기 · 웹훅	팀 소유자
연결 · 끊기	그 데이터베이스에 전체 허용 권한이 있는 팀 멤버(게스트 제외)

연결할 수 있는 데이터베이스

스페이스 데이터베이스와 접근 제한 데이터베이스를 연결할 수 있습니다. 다음은 연결할 수 없습니다.

개인 데이터베이스
세션 목록과 대화 보관함
시스템 데이터베이스
주인이 없는 데이터베이스

인라인 데이터베이스는 따로 연결하지 않습니다. 그 데이터베이스가 있는 문서의 데이터베이스를 연결하면 함께 보입니다.

연결하면 보이는 대상

그 데이터베이스의 행
행 아래의 하위 문서
그 행과 하위 문서 안에 있는 인라인 데이터베이스와 그 행

연결해도 보이지 않는 대상

대상	동작
권한을 따로 정한 행	그 행 · 하위 문서 · 안의 인라인 데이터베이스까지 없는 것으로 처리합니다. 직접 읽으면 404입니다.
본문의 링크된 보기가 가리키는 다른 데이터베이스	보기가 있어도 열리지 않습니다. 그 데이터베이스를 따로 연결하세요.
연결하지 않은 데이터베이스를 가리키는 관계 속성	데이터 소스의 `properties`에서 빠집니다. 행 값에는 `relation: []`과 `has_more: false`로 남습니다. 그 관계를 쓰는 롤업도 빈 값입니다.
연동이 읽지 못하는 문서 멘션	ID만 있고 `plain_text`는 `Untitled`입니다.
연동이 읽지 못하는 문서를 가리키는 카드	블록에서 `unsupported`(`block_type: "alias"`)입니다.

관계 필터는 대상 데이터베이스가 보이지 않아도 실제 관계를 기준으로 동작합니다. 롤업 필터와 정렬은 빈 값을 기준으로 동작합니다. 수식과 롤업 값은 연동이 볼 수 있는 행만으로 계산합니다.

연결하지 않았을 때의 응답

연결하지 않은 대상과 없는 대상은 구분되지 않습니다. 둘 다 404 object_not_found를 반환합니다.

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find data source with ID: exampleDb001. Make sure the relevant pages and databases are shared with your connection \"주문 동기화\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

연결 끊기

연동 상세에서 끊기를 누르면 그 즉시 그 데이터베이스는 404를 반환합니다. 웹훅도 바로 멈추고, 전송을 기다리던 이벤트도 전송하지 않습니다. 연결이 끊겼음을 알리는 이벤트는 없습니다.

휴지통에 있는 데이터베이스

연결한 데이터베이스를 휴지통에 넣어도 연결은 유지됩니다. 끊기 전까지 연동은 다음과 같이 읽습니다.

요청	응답
데이터베이스 · 데이터 소스 · 블록 읽기	200, `in_trash: true`
그 데이터베이스의 행 · 속성 · 마크다운 읽기	200. 행 객체는 `in_trash: true`입니다.
쿼리 · 블록 자식 읽기	404
검색	결과에 나오지 않습니다.
행 만들기 · 고치기	400 `Can't edit block that is archived...`

연동 상세에는 휴지통에 있음으로 표시되고, 여기서 끊을 수 있습니다.

시작하기

데이터 가져오기

인증과 권한

상한

웹훅

데이터베이스 연결하기

연결할 수 있는 데이터베이스

연결하면 보이는 대상

연결해도 보이지 않는 대상

연결하지 않았을 때의 응답

연결 끊기

휴지통에 있는 데이터베이스

​데이터베이스 연결하기

​연결할 수 있는 데이터베이스

​연결하면 보이는 대상

​연결해도 보이지 않는 대상

​연결하지 않았을 때의 응답

​연결 끊기

​휴지통에 있는 데이터베이스

데이터베이스 연결하기

연결할 수 있는 데이터베이스

연결하면 보이는 대상

연결해도 보이지 않는 대상

연결하지 않았을 때의 응답

연결 끊기

휴지통에 있는 데이터베이스