이 문서에서는 다음을 수행하는 방법을 보여줍니다.
새 저장소에 개발 작업공간을 처음 만들면 Dataform이 작동하는 데 필요한 구성 파일 집합으로 개발 작업공간을 초기화하라는 메시지가 표시됩니다.
초기화된 개발 작업공간에는 다음과 같은 디렉터리와 파일이 포함됩니다.
definitions/
: Dataform Core 또는 자바스크립트의 애셋 정의 디렉터리입니다.includes/
: 저장소에서 재사용할 수 있는 스크립트와 변수를 위한 빈 디렉터리입니다.dataform.json
: 애셋을 게시할 Google Cloud 프로젝트 ID 및 BigQuery 스키마가 포함된 기본 Dataform 구성 파일입니다. 필요에 따라 기본 설정을 재정의할 수 있지만 Dataform 사용을 시작하는 데 필수적이지는 않습니다.package.json
:@dataform/core
의 최신 버전이 포함된 기본 Dataform 종속 항목 구성 파일입니다. 이 파일을 사용하여 패키지 가져오기를 수행할 수 있습니다.definitions/sample.sqlx
: 시작하는 데 도움이 되는 샘플 SQLX 파일입니다.
시작하기 전에
아직 Dataform 저장소를 만들지 않았으면 Dataform 저장소를 만듭니다.
필요한 역할
개발 작업공간을 만들고 초기화하고 삭제하는 데 필요한 권한을 얻으려면 관리자에게 작업공간에 대한 Dataform 편집자(roles/dataform.editor
) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
Dataform 개발 작업공간 만들기
새 Dataform 개발 작업공간을 만들려면 다음 단계를 수행합니다.
Google Cloud 콘솔에서 Dataform 페이지로 이동합니다.
새 개발 작업공간을 만들 저장소를 선택합니다.
저장소 페이지에서 개발 작업공간 만들기를 클릭합니다.
개발 작업공간 만들기 창에서 다음을 수행합니다.
작업공간 ID 필드에 개발 작업공간의 고유 ID를 입력합니다.
ID에는 숫자, 문자, 하이픈, 밑줄만 포함할 수 있습니다.
만들기를 클릭합니다.
Dataform 저장소에서 첫 번째 개발 작업공간 초기화
Dataform 개발 작업공간을 초기화하려면 다음 단계를 수행합니다.
Google Cloud 콘솔에서 Dataform 페이지로 이동합니다.
빈 작업공간을 초기화할 저장소를 선택합니다.
개발 작업공간 탭에서 초기화하려는 빈 작업공간의 이름을 클릭합니다.
개발 작업공간 페이지에서 작업공간 초기화를 클릭합니다.
Dataform 개발 작업공간 삭제
Dataform 개발 작업공간을 만드는 데에는 비용이 들지 않습니다. 그래도 개발 작업공간을 삭제하려는 경우 다음 단계를 따르세요.
Dataform 페이지에서 삭제하려는 작업공간이 포함된 저장소를 클릭합니다.
커밋되지 않은 변경사항을 삭제하지 않으려면 변경사항을 커밋하고 Git 저장소로 푸시합니다.
개발 작업공간 탭에서 삭제하려는 개발 작업공간을 선택한 후 선택한 작업공간 삭제를 클릭합니다.
한 번에 작업공간을 여러 개 삭제할 수 있습니다.
삭제를 클릭하여 확인합니다.
다음 단계
테이블을 정의하는 방법은 테이블 정의를 참조하세요.
Dataform에 대한 자세한 내용은 Dataform 개요를 참조하세요.