콘텐츠로 건너뛰기
HubSpot 기술 자료
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

HubDB 테이블 생성 및 채우기

마지막 업데이트 날짜: 2025년 12월 15일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

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

시작하기 전에

이 기능을 사용하기 전에 사전에 수행해야 할 단계와 기능의 제한 사항, 사용 시 발생할 수 있는 결과를 완전히 이해해야 합니다. 

구독 필요 다음 구독이 필요합니다:

  • 동적 페이지에 HubDB를 사용하려면Content Hub Professional 또는 Enterprise가 필요합니다.
  • 마케팅 허브 프로그래밍 가능한 이메일에 HubDB를 사용하려면Enterprise가 필요합니다.

권한 필요 다음 권한이 필요합니다:

제한 사항 및 고려 사항 이해

  • 새로 생성된 모든 테이블은 초안 상태로 설정됩니다. 테이블이 게시되기 전까지는HubL 또는 API를 통해 데이터를 출력하는 데 사용할 수 없습니다.
  • HubDB 기술적 제한 사항을 검토하세요.

테이블 생성

  1. HubSpot 계정에서 콘텐츠 > HubDB로 이동합니다.
  2. 테이블 만들기를 클릭하세요.
  3. 대화 상자에서테이블 레이블과테이블이름을 입력하세요. 테이블을 게시한 후에는 이름을 변경할수 없습니다.
  4. 생성을 클릭하세요.

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

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

테이블 열 추가

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

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

테이블 행 추가

행은 테이블에 개별 레코드를 저장합니다. 구조화된 데이터로 테이블을 채우려면 행을 추가하거나 데이터 변경 시 기존 행을 업데이트하세요.

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

CSV 파일로 테이블 데이터 가져오기

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

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

참고:

  • 이미지를 HubDB 테이블로 가져오려면 CSV 파일에 이미지 URL을 추가하십시오. 이미지의 크기를 설정하려면 URL 끝에 쉼표로 구분하여 너비와 높이를 추가하십시오(예:http://www.hubspot.com/sample-image.jpg,100,300).
  • 가져온 날짜는 MM/DD/YYYY 형식을 사용해야 합니다. 예를 들어, 2022년 11월 6일은 11/06/2022로 표기됩니다. 

테이블 데이터 관리

HubDB 테이블의 구조와 내용을 관리하려면 열이나 행을 제거하거나 순서를 조정하세요. 이러한 작업은 테이블을 체계적으로 유지하고 웹사이트나 HubDB API를 통해 사용할 때 데이터가 올바르게 구조화되도록 보장합니다.

테이블 열 제거

  1. HubSpot 계정에서 콘텐츠 > HubDB로 이동합니다.
  2. 테이블 이름을 클릭하세요.
  3. 열 레이블 위에 마우스를 올려 놓고 드롭다운 메뉴를 클릭한 다음 제거를 선택합니다.
  4. 대화 상자에서 삭제를 클릭하세요.

A HubDB table is displayed. An arrow points to a Column label's dropdown menu and a box is placed around the option to remove the column.

테이블 행 제거

  1. HubSpot 계정에서 콘텐츠 > HubDB로 이동합니다.
  2. 테이블 이름을 클릭합니다.
  3. 행 ID 위에 마우스를 올려 놓고 드롭다운 메뉴를 클릭한 다음 제거를 선택합니다.

A HubDB table is displayed. An arrow points to a row ID dropdown menu and a box is placed around the option to remove the row.

테이블 열 및 행 순서 재정렬

  1. HubSpot 계정에서 콘텐츠 > HubDB로 이동합니다.
  2. 테이블 이름을 클릭합니다.
  3. 행 순서를 변경하려면 행 번호 위에 마우스를 올려 드래그 핸들 아이콘을 클릭하세요. 그런 다음 행을 위나 아래로 이동하여 새 위치에 배치하세요.

A HubDB table is displayed. A box is placed around the row ID to drag and drop the row into a new position.

  1. 열 순서를 변경하려면 열위에 마우스를올려 드래그 핸들 아이콘을 클릭하세요. 그런 다음 열을 좌우로 이동하여 새 위치로 배치하세요.

A HubDB table is displayed. A box is placed around the column label to drag and drop the column into a new position.

테이블 설정 관리

공개 API 접근 옵션 및 데이터로 동적 페이지 생성 가능 여부 등 개별 HubDB 테이블 설정을 관리하세요.

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

참고: 부모 테이블은 부모 테이블을 참조하는 자식 테이블을 참조할 수 없습니다. 이는 부모 테이블 내에서 자식 테이블을 선택하려고 할 때 오류가 발생하는 루프를 생성합니다.


테이블 게시

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

  1. HubSpot 계정에서 콘텐츠 > HubDB로 이동합니다.
  2. 테이블 이름을 클릭합니다.
  3. 오른쪽 상단에서 게시를 클릭하세요.
  4. 대화 상자에서 게시를 클릭하여 변경 사항을 적용합니다.

테이블 데이터 내보내기

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

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

테이블 종속 요소 보기

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

  1. HubSpot 계정에서 콘텐츠 > HubDB로 이동합니다.
  2. 작업 드롭다운 메뉴를 클릭하고 종속 항목 표시를 선택합니다.
  3. 대화 상자에서 자산 유형 (예: 블로그 게시물 또는 모듈)을 클릭하여 해당 섹션을 확장하고 개별 자산을 확인하세요.
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.
목차 메뉴

관련 콘텐츠

New call-to-action