HubDB 테이블 생성 및 데이터 입력

HubDB는 구조화된 데이터 테이블을 생성하고 관리하는 데 사용되는 데이터베이스 도구입니다. HubDB 테이블을 사용하여 동적 페이지를 생성하고, HubDB API를 통해 외부에서 테이블을 조회할 수 있습니다. HubDB는 구조화된 데이터(예: 제품 목록, 팀 디렉토리, 이벤트 일정 등)를 저장하므로, 여러 페이지를 개별적으로 업데이트하는 대신 중앙에서 정보를 한 번에 업데이트할 수 있습니다. HubSpot 개발자 문서에서 HubDB에 대해 자세히 알아보세요.

시작하기 전에

HubDB 테이블 작업을 시작하기 전에 요구 사항, 제한 사항 및 고려 사항을 확인하십시오.

제한 사항 및 고려 사항 이해하기

• 새로 생성된 모든 테이블은 '초안' 상태로 설정됩니다. 테이블이 게시되기 전까지는HubL이나 API를 통해 데이터를 출력하는 데 사용할 수 없습니다.
• 테이블에 변경 사항을 저장한다고 해서 라이브 페이지나 이메일이 즉시 업데이트되지는 않습니다. 변경 사항을 적용하려면 저장 후 테이블을 게시하십시오. 테이블을 게시한 후에도 라이브 페이지나 이메일에 이전 콘텐츠가 계속 표시된다면, 페이지나 이메일을 다시 게시하여 강제 재렌더링을 수행하십시오.
• HubDB의 기술적 제한 사항을 확인하십시오.

테이블 생성

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. '테이블 생성'을 클릭하십시오.
3. 대화 상자에서‘테이블 레이블 ’과‘테이블이름’을 입력하세요. 테이블을 게시한 후에는 이름을 변경할수 없습니다.
4. '생성'을 클릭합니다.

테이블 데이터 추가 또는 가져오기

테이블을 생성한 후에는 새 열과 행을 추가하여 웹사이트 페이지나 HubDB API를 통해 사용되는 데이터의 구조를 구성할 수 있습니다. 또한 CSV 파일을 가져와 해당 데이터를 HubDB 테이블에 병합할 수도 있습니다.

테이블 열 추가

열은 테이블의 각 부분에 저장되는 데이터의 유형을 정의합니다. 열을 추가할 때는 열 유형을 선택하고, 데이터 입력 및 사용 방식을 결정하는 설정을 구성합니다.

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을 클릭합니다.
3. 오른쪽 상단에서 '작업'드롭다운 메뉴를 클릭하고 '열 추가'를 선택합니다.
4. 대화 상자에서 열 레이블을 입력합니다.
5. '열 이름'을 입력합니다. 이 이름을 사용하여 HubDB API로 데이터를 쿼리할 수 있습니다.
6. '열 설명'을 입력하세요. 이 설명은 사용자가 열 이름 옆의 정보 아이콘 위에 마우스를 올렸을 때 표시됩니다.
7. '열 유형' 드롭다운 메뉴를 클릭하고 열 유형을 선택합니다. 일부 열 유형의 경우 구성할 수 있는 추가 옵션(예: '단일 선택' 또는 '다중 선택')이 표시됩니다.
8. 완료되면 ‘열 추가’를 클릭합니다.

테이블 행 추가

행은 테이블에 개별 레코드를 저장합니다. 행을 추가하여 테이블에 구조화된 데이터를 채우거나, 데이터가 변경될 때 기존 행을 업데이트할 수 있습니다.

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을 클릭하세요.
3. 오른쪽 상단의 '작업'드롭다운 메뉴를 클릭하고 '행 추가'를 선택하십시오.
4. 새로운 행이 생성됩니다. 테이블에 기존 행이 있는 경우, 새 행은 기존 행들 바로 아래에 추가됩니다. 테이블에 대해 구성한 각 열에 값을 입력하십시오.

CSV 파일을 사용하여 테이블 데이터 가져오기

CSV 파일에서 데이터를 가져와 HubDB 테이블에 여러 행을 한 번에 추가할 수 있습니다. 이는 대용량 데이터 세트를 처리하거나 기존 정보를 HubDB로 마이그레이션할 때 유용합니다.

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을클릭합니다.
3. 오른쪽 상단의 '작업'드롭다운 메뉴를 클릭하고 '가져오기'를 선택합니다.
4. '추가 또는 대체' 타일을 클릭하세요:
   • 추가: 스프레드시트의 행이 기존 데이터에 추가됩니다.
   • '바꾸기': 스프레드시트의 행이 테이블에 있는 기존 데이터를 덮어쓰고 대체합니다. 스프레드시트에 행 ID가 포함된 경우, 행이 대체되는 대신 업데이트됩니다.
5. '다음'을 클릭합니다.
6. '파일 선택 ' 페이지에서 '파일 선택'을 클릭하십시오.
7. 파일 시스템에서 CSV 파일을 찾아'열기'를 클릭합니다.
8. 기본적으로 HubSpot은 CSV 파일 내 데이터의 인코딩을 자동으로 감지합니다. 데이터 인코딩을 수동으로 지정하려면:
   • '고급 옵션'을 클릭합니다.
   • '데이터 인코딩 사용자 지정 ' 드롭다운 메뉴를 클릭한 다음 인코딩을 선택합니다.
9. '다음'을 클릭합니다.
10. '열 매핑' 페이지에서 CSV의 각 필드를 해당 HubDB 테이블 열에 어떻게 매핑할지 지정합니다:
    • 'HubDB 테이블 열 ' 드롭다운 메뉴를 클릭한 다음열을 선택합니다.
    • CSV 필드에 대해 연관된 열을 구성하지 않은 경우, [ 열 추가] 를 클릭하십시오. 대화 상자에서 레이블과 이름을 입력하고 유형을 선택하십시오. 완료되면 [ 열 추가]를 클릭하십시오.
11. 완료되면 ‘가져오기’를 클릭합니다.
12. 가져오기가 완료되면 ‘완료’를 클릭하십시오.

테이블 데이터 관리

열이나 행을 제거하거나 순서를 조정하여 HubDB 테이블의 구조와 내용을 관리할 수 있습니다. 이러한 작업을 통해 테이블을 체계적으로 정리하고, 웹사이트나 HubDB API에서 사용할 수 있도록 데이터가 올바르게 구조화되도록 할 수 있습니다.

테이블 열 제거

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을 클릭하십시오.
3. 열 레이블 위에 마우스를 올려놓고 드롭다운 메뉴를 클릭한 다음, '제거'를 선택하십시오.
4. 표시되는 대화 상자에서 '삭제'를 클릭하십시오.

테이블 행 제거

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을 클릭합니다.
3. 행 ID 위에 마우스를 올려놓고 드롭다운 메뉴를 클릭한 다음, '제거'를 선택합니다.

테이블 열 및 행 순서 재정렬

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을 클릭합니다.
3. 행의 순서를 변경하려면 행 번호 위에 마우스를 올려놓고 드래그 앤 드롭 아이콘을 클릭하십시오. 그런 다음 행을 위나 아래로 이동하여 새로운 위치에 배치하십시오.

4. 열의 순서를 변경하려면 열위에 마우스를올려놓고 드래그 앤 드롭 아이콘( dragHandleIcon)을 클릭하십시오. 그런 다음 열을 왼쪽이나 오른쪽으로 이동하여 새로운 위치에 배치하십시오.

테이블 설정 관리

공개 API 액세스 옵션 및 데이터를 동적 페이지 생성에 사용할 수 있는지 여부를 포함하여 개별 HubDB 테이블 설정을 관리할 수 있습니다.

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블이름을 클릭하세요.
3. 오른쪽 상단의 '작업' 드롭다운 메뉴를 클릭하고 '설정 관리'를 선택합니다.
4. 오른쪽 패널에서 '공개 API 액세스 허용' 스위치를 켜서 테이블 데이터를 조회하기 위한 인증되지 않은 API 호출을 활성화하세요.
   • 기본적으로 테이블 데이터는 HubL 또는 인증된 API 호출을 통해서만 HubSpot에서 액세스할 수 있습니다.
   • 데이터를 조회하려면 portalId 쿼리 매개변수에 HubSpot 계정 ID를 포함해야 합니다.
5. 테이블을 사용하여 동적 페이지를 생성하려면 '행 데이터를 사용하여 동적 페이지 생성 허용' 스위치를 켜십시오. 그런 다음 다음과 같은 추가 옵션을 구성할 수 있습니다.
   • '메타데이터' 섹션에서드롭다운 메뉴를 클릭하고, 메타 설명, 추천 이미지 및 표준 URL 데이터로 동적 페이지를 채울 열을 선택하십시오. 새 테이블의 경우, 이 데이터를 포함할 새 열을 생성해야 합니다.
     • 메타 설명:텍스트 유형의 열이어야 합니다.
     • 대표 이미지:이미지 유형의 열이어야 합니다.
     • 정식 URL:URL 유형의 열이어야 합니다.
   • '하위 테이블 ' 섹션에서 '하위 테이블 사용 허용' 확인란을 선택하여 이 테이블에서 다른 HubDB 테이블에 대한 참조를 활성화하십시오.
   • 중간 목록 페이지를 자동으로 생성하려면 '자식 테이블에 대한 목록 페이지 자동 생성' 확인란을 선택하십시오.HubDB를 사용하여 다단계 동적 페이지를 구축하는 방법에 대해 자세히 알아보세요.
6. 작업이 완료되면 ‘저장’을 클릭하십시오.

참고: 상위 테이블은 자신도 참조하는 하위 테이블을 참조할 수 없습니다. 이렇게 하면 루프가 발생하여 상위 테이블 내에서 하위 테이블을 선택하려고 할 때 오류가 발생합니다.

테이블 게시

HubDB 테이블을 게시하여 웹사이트나 HubDB API를 통해 최신 구조와 데이터를 사용할 수 있도록 하세요. 테이블을 생성하거나 열 또는 행을 업데이트한 후에는 변경 사항이 적용되도록 테이블을 게시하세요.

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을 클릭합니다.
3. 오른쪽 상단에서 '게시'를 클릭합니다.
4. 표시되는 대화 상자에서 ‘게시’를 클릭하여 변경 사항을 적용하십시오.

테이블 데이터 내보내기

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. 테이블 이름을 클릭합니다.
3. 오른쪽 상단에서 '작업' 드롭다운 메뉴를 클릭하고 '내보내기'를 선택합니다. 그런 다음 파일 형식 옵션 (예: CSV)을 선택합니다. HubDB 테이블 데이터가 즉시 다운로드되기 시작합니다.

참고: HubDB 테이블에서 내보낸 이미지는 이미지 URL 형식으로 제공됩니다. 이미지의 크기가 사용자 정의된 경우, 해당 크기가 URL 끝에 표시됩니다.

테이블 종속 항목 확인

HubDB 테이블을 업데이트하거나 삭제하기 전에, 해당 테이블에 의존하는 자산이 무엇인지 확인하십시오. 테이블 의존 항목을 확인하면 변경 사항이 웹사이트 콘텐츠나 API 사용에 미치는 영향을 파악하는 데 도움이 됩니다.

1. HubSpot 계정에서 더 보기를 클릭한 다음 콘텐츠 > HubDB로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 콘텐츠 > HubDB로 이동하세요.
2. '작업' 드롭다운 메뉴를 클릭하고 '종속 항목 표시'를 선택합니다.
3. 대화 상자에서 자산 유형 (예: 블로그 게시물 또는 모듈)을 클릭하여 해당 섹션을 확장하고 개별 자산을 확인하십시오.