Snowflake CLI 를 사용하여 DCM 관리하기¶

Snowflake CLI 를 사용하여 DCM project 를 관리할 수 있습니다. DCM 프로젝트에 대한 자세한 내용은 Snowflake DCM Projects 섹션을 참조하세요.

DCM project 기능을 사용하여 Snowflake CLI 설치하기¶

snow dcm 명령을 사용하려면 Snowflake CLI 버전 3.16.0 이상을 설치해야 합니다. 자세한 내용은 Snowflake CLI 설치하기 섹션을 참조하십시오.

Snowflake에 유효한 연결이 있는지 확인¶

Snowflake CLI가 Snowflake와 상호 작용하려면 작동하는 연결이 필요합니다. 연결 관리에 대한 자세한 내용은 Snowflake CLI 구성하기 섹션을 참조하세요.

Snowflake CLI 에서 DCM 명령 활성화¶

DCM 명령을 사용하려면 다음 방법 중 하나를 사용하여 SNOWFLAKE_CLI_FEATURES_ENABLE_SNOWFLAKE_PROJECTS 기능 플래그를 활성화해야 합니다.

명령을 실행하기 전에 SNOWFLAKE_CLI_FEATURES_ENABLE_SNOWFLAKE_PROJECTS 환경 변수를 :codenowrap:`true`로 설정합니다.
다음 예제에서와 같이 config.toml 파일에서 enable_snowflake_projects 구성 옵션을 :codenowrap:`true`로 설정합니다.
```
[cli.features]
enable_snowflake_projects = true
```

템플릿에서 DCM project 초기화¶

템플릿에서 DCM project 를 초기화하려면 snow init 명령을 사용합니다.
```
snow init <project_dir_name> --template dcm_project
```
여기서, <project_dir_name>`은 |dcmp| 파일이 있는 디렉터리입니다. 이 디렉터리는 :codenowrap:`snow init 명령에 의해 생성되며, 지정된 템플릿에서 생성된 프로젝트 파일로 채워집니다.

예를 들어, 다음 명령은 MY_PROJECT 디렉터리에 프로젝트 파일을 생성합니다.
```
snow init MY_PROJECT --template dcm_project
```

Snowflake CLI 명령¶

DCM Projects 를 지원하기 위해 |sf-cli|에 다음 명령이 추가되었습니다.

DCM projects 생성 및 배포¶

이 섹션에서는 Snowflake CLI 를 사용하여 DCM projects 를 생성하고, 유효성을 검사하고, 배포하는 방법에 대해 설명합니다.

다음 경우에 |dcmp|를 만듭니다.¶

snow dcm create 명령을 사용하여 Snowflake에서 새 DCM project 를 생성합니다. 프로젝트 식별자는 인자로 직접 지정하거나 manifest.yml 파일에서 확인할 수 있습니다.

매니페스트에 지정된 기본 대상의 식별자를 사용하여 프로젝트를 생성합니다.
```
snow dcm create
```
매니페스트에 지정된 dev 대상의 식별자를 사용하여 프로젝트를 생성합니다.
```
snow dcm create --target dev
```
프로젝트가 아직 없는 경우에만 프로젝트를 생성합니다.
```
snow dcm create --if-not-exists
```

자세한 내용은 snow dcm create 섹션을 참조하십시오.

DCM project 계획¶

배포하기 전에 snow dcm plan 명령을 사용하여 프로젝트의 유효성을 검사합니다. 이 명령은 실제로 수정하지 않고 적용되는 변경 사항을 보여줍니다.

프로젝트 유효성을 검사합니다.
```
snow dcm plan
```
변수 대체를 사용하여 유효성을 검사합니다.
```
snow dcm plan -D "db_name=my_database" -D "schema_name=my_schema"
```
특정 대상 프로필을 사용하여 유효성을 검사하고 출력을 저장합니다.
```
snow dcm plan --target dev --save-output
```
--save-output`을 사용하는 경우, 명령은 응답과 아티팩트를 로컬 :file:`out/ 디렉터리에 저장합니다.

자세한 내용은 snow dcm plan 섹션을 참조하십시오.

DCM project 배포¶

snow dcm deploy 명령을 사용하여 DCM project 에 정의된 변경 사항을 Snowflake에 적용합니다.

프로젝트를 배포합니다.
```
snow dcm deploy
```
변수 대체를 사용하여 배포합니다.
```
snow dcm deploy -D "table_name='MY_DB.PUBLIC.MY_TABLE'"
```
배포의 별칭을 사용하여 배포합니다.
```
snow dcm deploy --alias v1.0
```
대상 프로필을 사용하여 특정 디렉터리에서 배포합니다.
```
snow dcm deploy --from /path/to/project --target prod
```

자세한 내용은 snow dcm deploy 섹션을 참조하십시오.

DCM project 미리 보기¶

snow dcm preview 명령을 사용하여 프로젝트에 정의된 테이블, 뷰 또는 동적 테이블에서 행을 반환합니다. 이 명령은 배포 전후에 정의를 테스트하는 데 유용합니다.

테이블에서 데이터를 미리 봅니다.
```
snow dcm preview --object MY_DB.PUBLIC.MY_TABLE
```
행 제한을 사용하여 미리 봅니다.
```
snow dcm preview --object MY_DB.PUBLIC.MY_VIEW --limit 10
```
변수 대체를 사용하여 미리 봅니다.
```
snow dcm preview --object MY_DB.PUBLIC.MY_VIEW -D "filter_date='2024-01-01'"
```

자세한 내용은 snow dcm preview 섹션을 참조하십시오.

DCM project 테스트하기¶

snow dcm test 명령을 사용하여 프로젝트에 정의된 모든 기대치(데이터 메트릭 함수)를 실행합니다. 이 명령은 데이터 품질 규칙의 유효성을 검사하고 성공/실패 결과를 반환합니다.

프로젝트를 테스트합니다.
```
snow dcm test
```
대상 프로필을 사용하여 테스트합니다.
```
snow dcm test --target dev
```
결과를 테스트하고 저장합니다.
```
snow dcm test --save-output
```

명령은 모든 테스트가 통과하면 종료 코드 0을 반환하고, 테스트가 실패하면 종료 코드 1을 반환합니다.

자세한 내용은 snow dcm test 섹션을 참조하십시오.

DCM project 새로 고침¶

snow dcm refresh 명령을 사용하여 |dcmp|에 정의된 모든 동적 테이블을 새로 고칩니다. 그러면 데이터가 즉시 새로 고쳐집니다.

프로젝트의 동적 테이블을 새로 고칩니다.
```
snow dcm refresh
```
대상 프로필을 사용하여 새로 고칩니다.
```
snow dcm refresh --target prod
```
출력을 새로 고치고 저장합니다.
```
snow dcm refresh --save-output
```

명령은 삽입된 행 수 및 삭제된 행 수를 포함하여 각 동적 테이블의 상태를 보고합니다.

자세한 내용은 snow dcm refresh 섹션을 참조하십시오.

DCM project 삭제¶

snow dcm drop 명령을 사용하여 DCM project 를 삭제합니다. 이 명령은 프로젝트 및 프로젝트의 모든 버전을 삭제합니다. 프로젝트와 연결된 스테이지는 삭제되지 않습니다.

프로젝트를 삭제합니다.
```
snow dcm drop
```
프로젝트가 있는 경우에만 프로젝트를 삭제합니다.
```
snow dcm drop --if-exists
```

자세한 내용은 snow dcm drop 섹션을 참조하십시오.

배포된 DCM projects 관리¶

DCM project 가 배포된 후 개별 배포를 나열하고 관리할 수 있습니다.

배포된 DCM projects 나열¶

codenowrap:snow dcm list-deployments 명령을 사용하여 주어진 DCM project 의 모든 배포를 나열합니다.

프로젝트의 배포를 나열합니다.
```
snow dcm list-deployments
```
대상 프로필을 사용하여 배포를 나열합니다.
```
snow dcm list-deployments --target dev
```

출력에는 각 배포의 배포 이름과 별칭(설정된 경우)이 표시됩니다.

자세한 내용은 snow dcm list-deployments 섹션을 참조하십시오.

배포된 DCM projects 삭제¶

snow dcm drop-deployment 명령을 사용하여 DCM project 에서 특정 배포를 삭제합니다.

이름으로 배포를 삭제합니다.
```
snow dcm drop-deployment --deployment 'DEPLOYMENT$1'
```
참고

:codenowrap:`$`가 포함된 배포 이름의 경우 작은따옴표를 사용하여 셸 확장을 방지합니다.
별칭으로 배포를 삭제합니다.
```
snow dcm drop-deployment --deployment v1.0
```
배포가 있는 경우에만 배포를 삭제합니다.
```
snow dcm drop-deployment --deployment v1.0 --if-exists
```

자세한 내용은 snow dcm drop-deployment 섹션을 참조하십시오.