dbt 클라우드 수집기 실행 준비

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분

    • 수집기를 실행하기 전에 dbt Cloud를 구성하고 인증 토큰을 생성합니다.

    시작하기 전에

    필요한 역할: 없음

    이 태스크 정보

    dbt 클라우드 수집기를 실행하기 전에 이러한 준비 작업을 완료합니다.

    프로시저

    1. dbt 클라우드에서 필요한 ID를 가져옵니다.

      계정, 프로젝트, 작업 및 실행 ID 가져오기 문서를 참조하십시오.

    2. dbt 클라우드 계획에 따라 API 토큰을 생성합니다.
    3. 작업 설정에서 문서 생성을 활성화합니다.

      작업 실행 설정 업데이트 문서를 참조하십시오.

    계정, 프로젝트, 작업 및 실행 ID 가져오기

    수집기 구성에 필요한 ID를 dbt 클라우드 URL에서 가져옵니다.

    시작하기 전에

    필요한 역할: 없음

    이 태스크 정보

    메타데이터 수집을 위해 수집기를 구성할 때 이 정보를 사용합니다.

    프로시저

    1. 계정 ID와 프로젝트 ID를 가져옵니다.
      1. 다음으로 이동 배포 > 작업.
      2. URL에서 계정 ID와 프로젝트 ID를 복사합니다.

        URL 형식:

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/jobs
    2. 환경 ID 및 환경 이름을 가져옵니다.
      1. 다음으로 이동 배포 > 환경.
      2. 수집기를 실행할 환경을 선택합니다.
      3. URL에서 환경 ID를 복사하거나 페이지 제목에서 환경 이름을 기록해 둡니다.

        URL 형식:

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/environments/<environmentID>
    3. 작업 ID를 가져옵니다.
      1. 작업 섹션에서 환경과 연결된 작업을 선택합니다.
      2. URL에서 작업 ID를 복사하거나 페이지 제목에서 작업 이름을 기록해 둡니다.

        URL 형식:

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/jobs/<jobID>
    4. 옵션: : 특정 작업 실행 ID를 가져옵니다.

      기본적으로 수집기는 가장 최근에 성공한 작업 실행에서 수집합니다. 특정 실행에서 수집하려면 다음 단계를 완료합니다.

      1. 작업 페이지에서 특정 작업 실행을 선택합니다.
      2. URL에서 작업 실행 ID를 복사합니다.

        URL 형식:

        https://cloud.getdbt.com/deploy/<accountID>/projects/<projectID>/runs/<jobRunID>

    사용자 토큰 생성

    메타데이터 수집을 위한 개인 액세스 토큰을 생성합니다.

    시작하기 전에

    필요한 역할: 관리자

    필요한 계획: 팀.

    이 태스크 정보

    팀 플랜은 서비스 계정 토큰을 지원하지 않습니다. 전용 사용자 계정을 사용하여 개인용 액세스 토큰을 생성해야 합니다.

    프로시저

    1. 수집기용 전용 사용자 계정을 생성합니다.
    2. 사용자 계정에 관리자 역할을 할당합니다.
    3. 전용 사용자로 로그인합니다.
    4. 다음으로 이동 프로필 > 접근 토큰.
    5. 개인 액세스 토큰을 생성합니다.
    6. 토큰 값을 복사합니다.

      수집기를 구성할 때 dbt 클라우드 API 키에 이 토큰 값을 사용합니다.

    다음에 수행할 작업

    자세한 내용은 dbt 클라우드 사용자 토큰 설명서 를 참조하십시오.

    서비스 토큰 작성

    메타데이터 수집에 필요한 권한이 있는 서비스 계정 토큰을 생성합니다.

    시작하기 전에

    필요한 역할: 관리자

    필요한 계획: Enterprise.

    이 태스크 정보

    엔터프라이즈 계정의 경우 서비스 계정 토큰은 일반적으로 프로덕션 시스템에 사용됩니다.

    프로시저

    1. 서비스 계정 토큰을 생성합니다.

      dbt 클라우드 서비스 토큰 설명서의 단계를 따릅니다.

    2. 서비스 계정 토큰에 역할을 할당합니다.
      • 계정 뷰어: 계정 수준에서 할당됨
      • 작업 뷰어: 메타데이터를 수집할 각 프로젝트에 대해 프로젝트 수준에서 할당됩니다.
    3. 토큰 값을 복사합니다.

      수집기를 구성할 때 dbt 클라우드 API 키에 이 토큰 값을 사용합니다.

    작업 실행 설정 업데이트

    dbt 클라우드 작업 설정에서 문서 생성을 활성화합니다. dbt 자원을 성공적으로 수집하려면 이 설정을 활성화해야 합니다.

    시작하기 전에

    필요한 역할: 관리자

    dbt 자원을 성공적으로 수집하려면 이 설정을 활성화해야 합니다.

    프로시저

    1. 다음으로 이동 배포 > 작업.
    2. 환경 목록에서 수집기를 실행할 환경을 선택합니다.
    3. 환경과 연결된 작업을 선택합니다.
    4. 설정을 선택합니다.
    5. 실행 설정에서 실행 시 문서 생성을 선택합니다.