자습서: Snowflake Native App Framework를 사용하여 Snowflake Native App 개발¶
소개¶
이 자습서에서는 Snowflake Native App Framework 를 사용하여 데이터 및 관련 비즈니스 논리를 다른 Snowflake 계정과 공유하기 위한 Snowflake Native App 을 만드는 방법을 설명합니다.
이 자습서에서는 Snowflake CLI 및 Snowsight 웹 인터페이스를 모두 사용합니다.
알아볼 내용¶
이 자습서에서는 다음에 대해 설명합니다.
애플리케이션의 데이터 및 비즈니스 논리를 포함하는 애플리케이션 패키지를 생성합니다.
애플리케이션 패키지와 데이터를 공유합니다.
애플리케이션 패키지에 비즈니스 논리를 추가합니다.
애플리케이션을 로컬에서 테스트합니다.
Snowsight 에서 앱을 보고 테스트합니다.
비공개 목록을 생성하여 앱을 게시합니다.
비공개 목록에서 앱을 설치합니다.
Snowflake CLI 를 사용하여 위의 여러 단계를 수행합니다.
공급자 및 컨슈머 정보¶
Snowflake Native App Framework 의 컨텍스트 내에서 공급자는 컨슈머인 다른 Snowflake 사용자와 공유할 데이터와 비즈니스 논리를 가진 역할과 조직입니다. 컨슈머는 조직 내 다른 계정, 회사 내 다른 조직 또는 다른 회사의 Snowflake 사용자일 수 있습니다.
이 자습서의 컨텍스트 내에서 수행하게 될 작업은 대부분 일반적으로 공급자가 수행하는 작업이지만, 여기에는 애플리케이션 개발자와 데이터베이스 관리자를 포함하여 조직 내의 여러 역할이 수행할 수 있는 작업이 포함됩니다.
이 자습서에서는 앱을 설치하기 위해 컨슈머가 수행하는 작업을 모방하는 작업도 수행합니다.
전제 조건¶
사용자의 컴퓨터에 Snowflake CLI 가 설치되어 있어야 합니다.
세션 컨텍스트가 필요하므로 동일한 SQL 명령 세션에서 모든 SQL 명령을 실행해야 합니다.
예를 들어 Snowsight 에서 이 작업을 수행하려면 단계를 진행하면서 모든 코드를 같은 워크시트에 붙여넣으십시오. 한 섹션에서 다음 섹션으로 진행할 때 각 섹션은 이전 섹션을 기반으로 합니다.
ACCOUNTADMIN 역할을 사용할 수 있어야 합니다.
이 자습서에서는 ACCOUNTADMIN 역할을 사용하여 모든 단계를 수행합니다. 하지만 일반적으로 수행 중인 작업에 대해 특별히 정의된 권한이 있는 역할을 사용하게 될 것입니다. 예를 들어 UDF와 저장 프로시저를 만드는 개발자, 역할과 권한을 관리하는 데이터베이스 관리자, Snowflake Collaboration을 사용하여 목록을 관리하는 관리자의 역할이 따로 있을 수 있습니다.
비공개 목록에서 애플리케이션을 설치하려면 두 번째 Snowflake 계정에 대한 액세스 권한이 있어야 합니다. 이 계정을 사용하여 컨슈머가 애플리케이션을 설치하는 방법을 모방합니다.
참고
Snowflake Native App Framework 는 다른 조직의 계정과의 애플리케이션 공유를 지원하지만, 이 자습서의 목적상 두 계정은 같은 조직에 있어야 합니다.
현재 웨어하우스를 설정해야 합니다. USE WAREHOUSE 섹션을 참조하십시오.
애플리케이션 파일 만들기¶
이 섹션에서는 설치 스크립트, 매니페스트 파일, 프로젝트 정의 파일을 만듭니다. 이 파일 중 첫 두 개는 Snowflake Native App Framework 에 필요합니다.
- 설정 스크립트
컨슈머가 자신의 계정에 애플리케이션을 설치할 때 자동으로 실행되는 SQL 스크립트입니다.
- 매니페스트 파일
애플리케이션에 대한 기본적인 구성 정보가 포함된 YAML 파일입니다.
- 프로젝트 정의 파일
생성할 Snowflake 오브젝트에 대한 정보가 포함된 YAML 파일입니다.
이 자습서 전체에서 이러한 파일과 그 내용에 대해 자세히 알아보겠습니다. 또한 이 자습서의 후반부에 애플리케이션을 보고 게시할 때 유용할 추가 정보 파일을 만들어 보겠습니다.
새 프로젝트 폴더 초기화¶
Snowflake CLI 를 사용하여 로컬 파일시스템에 새 Snowflake Native App 프로젝트를 초기화합니다.
이를 수행하려면 다음 명령을 실행합니다.
snow init --template app_basic tutorial
이 명령은 현재 작업 디렉터리 안에 이름이 tutorial
인 폴더를 생성하고 기본 템플릿을 기반으로 기본 Snowflake Native App 프로젝트로 채웁니다. 이 디렉터리는 모든 애플리케이션 파일의 루트 디렉터리입니다.
참고
이후 섹션에서 이 폴더에 파일과 하위 폴더를 수정하고 추가할 것입니다.
참고
네이티브 애플리케이션을 빠르게 시작하고 실행하는 데 유용한 다른 템플릿도 있습니다. 자세한 내용은 snow init --help
에 문의하십시오.
설정 스크립트 만들기¶
다음 예제와 같이 app/setup_script.sql
파일의 내용을 수정하거나 바꿉니다.
-- Setup script for the Hello Snowflake! app.
설정 스크립트를 비워둘 수 없으므로 이 줄은 자리 표시자입니다.
참고
이 자습서에서는 설정 스크립트에 대한 특정 구조와 파일 이름을 참조하십시오. 하지만 자체 애플리케이션을 만들 때 이 파일의 고유한 이름과 디렉터리 구조를 선택할 수 있습니다.
애플리케이션용 README 파일 만들기¶
추가 정보 파일에는 애플리케이션이 수행하는 작업에 대한 설명이 나와 있습니다. Snowsight 에서 애플리케이션을 볼 때 추가 정보가 표시됩니다.
app/README.md
의 내용을 다음과 같이 수정하거나 바꿉니다.
This is the readme file for the Hello Snowflake app.
매니페스트 파일 만들기¶
Snowflake Native App Framework 에는 각 앱에 대한 매니페스트 파일이 필요합니다. 매니페스트 파일에는 앱에 대한 메타데이터와 구성 매개 변수가 포함되어 있으며 앱의 런타임 동작에 영향을 미칩니다.
참고
이 파일의 이름은 manifest.yml
로 지정해야 합니다. 설정 스크립트를 포함한 다른 파일의 경로는 이 파일의 위치에 대한 상대 경로입니다.
app/manifest.yml
의 내용을 다음과 같이 수정하거나 바꿉니다.
manifest_version: 1
artifacts:
setup_script: setup_script.sql
readme: README.md
setup_script
속성에 따라 매니페스트 파일의 위치를 기준으로 설정 스크립트의 위치가 지정됩니다. 여기에 지정된 경로 및 파일 이름은 위에서 수정한 설정 스크립트의 상대 위치와 동일해야 합니다. readme
속성도 동일한 규칙을 따릅니다.
참고
manifest_version
, artifacts
및 setup_script
속성이 필요합니다. readme
속성은 선택 사항입니다.
프로젝트 정의 파일을 만듭니다.¶
Snowflake CLI는 프로젝트 정의 파일을 사용하여 Snowflake에 배포할 수 있는 오브젝트를 설명합니다. 이 파일의 이름은 snowflake.yml
로 지정해야 합니다. 이 파일은 배포된 애플리케이션 패키지 및 오브젝트의 이름과 프로젝트 스테이지에 업로드되는 파일을 제어합니다.
참고
이 파일의 이름은
snowflake.yml
이어야 하며 파일은 프로젝트의 루트 수준에 있어야 합니다.manifest.yml
및 설정 스크립트와 같은 다른 파일의 경로는 이 파일의 위치를 기준으로 합니다.
snowflake.yml
의 내용을 다음과 같이 수정하거나 바꿉니다.
definition_version: 2 entities: hello_snowflake_package: type: application package stage: stage_content.hello_snowflake_stage manifest: app/manifest.yml artifacts: - src: app/* dest: ./ hello_snowflake_app: type: application from: target: hello_snowflake_package debug: false
이 자습서의 다음 섹션에서는 이러한 각 속성을 사용하는 방법을 설명합니다.
이 섹션에서 학습한 내용 복습하기¶
이 섹션의 단계를 수행한 후에는 이제 다음과 같은 디렉터리 구조가 있어야 합니다.
/tutorial
snowflake.yml
README.md
/app/
manifest.yml
README.md
setup_script.sql
이 섹션에서는 Snowflake Native App Framework 에 필요한 설정 스크립트 및 매니페스트 파일과 Snowflake CLI에 필요한 프로젝트 정의 파일을 생성하는 방법을 알아봤습니다.
설정 스크립트와 매니페스트 파일에 추가한 내용은 기본이지만 모든 앱에는 이러한 파일이 있어야 합니다.
또한 Snowsight 에서 앱을 볼 때 또는 앱을 목록으로 게시할 때 표시되는 readme 파일을 추가했습니다.
프로젝트 정의 파일 이해하기¶
이 섹션에서는 이전 섹션에서 생성한 프로젝트 정의 파일(snowflake.yml
)의 내용에 대해 알아봅니다. 또한 공급자 계정에 대한 추가 설정 작업도 수행합니다.
기본적으로 애플리케이션 패키지는 애플리케이션에 대한 추가 정보를 포함하도록 확장된 Snowflake 데이터베이스입니다. 그런 의미에서는 다음을 포함하는 애플리케이션의 컨테이너입니다.
공유 데이터 콘텐츠
애플리케이션 파일
애플리케이션 패키지를 만들려면 역할에 CREATE APPLICATION PACKAGE 권한이 있어야 합니다. Snowflake CLI를 사용하여 이 권한을 부여하려면 다음 명령을 실행합니다.
snow sql -q 'GRANT CREATE APPLICATION PACKAGE ON ACCOUNT TO ROLE accountadmin' -c connection_name여기서
connection_name
은 Snowflake CLI를 설치할 때config.toml
파일에 지정한 연결의 이름입니다.
참고
ACCOUNTADMIN 역할에 기본적으로 이 권한이 있지만 애플리케이션 패키지를 만들 수 있으려면 자신의 역할에 이 권한이 부여되었는지 확인해야 합니다.
프로젝트 정의 파일(snowflake.yml
)은 Snowflake 계정에서 생성되는 오브젝트의 이름을 정의합니다.
애플리케이션 패키지(
hello_snowflake_package
)애플리케이션 패키지에서 생성된 애플리케이션 오브젝트(
hello_snowflake_app
)애플리케이션 파일을 보관하는 스테이지(
stage_content.hello_snowflake_stage
)
스테이지의 이름은 스키마 정규화된 이름으로 지정됩니다. 이 스키마는 애플리케이션 패키지 내부에 생성됩니다. 이 명명된 스테이지에는 Snowflake Native App Framework 에 필요한 파일을 저장하는 데 사용됩니다. 이 스테이지에는 앱 설정 스크립트의 설정 스크립트나 런타임에 사용할 수 있는 모든 파일이 포함되어야 합니다.
또한 프로젝트 정의 파일에는 이름이 artifacts
인 섹션도 있으며, 이 섹션은 지정된 스테이지에 복사할 파일을 지정하는 규칙 목록입니다.
이 규칙은 app/
하위 폴더에 있는 모든 항목이 스테이지의 루트에 복사되도록 지정합니다. 이는 다음을 의미합니다.
tutorial/app/manifest.yml
은@hello_snowflake_package.stage_content.hello_snowflake_stage
의 루트에 업로드됩니다.tutorial/app/README.md
는@hello_snowflake_package.stage_content.hello_snowflake_stage
의 루트에 업로드됩니다.tutorial/app/setup_script.sql
은@hello_snowflake_package.stage_content.hello_snowflake_stage
의 루트에 업로드됩니다.
아직 애플리케이션 패키지를 만들거나 이러한 작업을 수행하는 SQL 명령을 실행하지 않습니다. 이후 섹션에서 이러한 작업을 수행하기 위해 Snowflake CLI 명령을 실행합니다.
마지막으로 앱 정의 내에서 debug: false
를 설정합니다. Snowflake CLI를 사용하여 배포된 애플리케이션의 경우 디버그 모드가 기본적으로 활성화됩니다.
이 섹션에서는 애플리케이션 패키지가 애플리케이션에서 사용하는 리소스의 컨테이너라는 점을 알아봤습니다. 또한 프로젝트 정의 파일에서 필드를 설정하는 방법도 알아봤습니다.
애플리케이션 논리 추가 및 첫 번째 앱 설치¶
이 섹션에서는 애플리케이션 패키지에 코드를 추가하고 첫 번째 앱을 설치합니다. 이를 위해 다음 작업을 수행합니다.
설정 스크립트에 저장 프로시저를 추가합니다.
스테이지 개발 모드에서 앱을 설치하고 테스트합니다.
설정 스크립트에 저장 프로시저 추가하기¶
이 섹션에서는 로컬 파일 시스템의 설정 스크립트에 저장 프로시저의 코드를 추가하여 애플리케이션에 저장 프로시저를 추가합니다.
설정 스크립트에 저장 프로시저를 추가하려면 다음을 수행하십시오.
이 자습서의 이전 섹션에서 만든
setup_script.sql
파일의 끝에 다음 SQL 문을 추가합니다.CREATE APPLICATION ROLE IF NOT EXISTS app_public; CREATE SCHEMA IF NOT EXISTS core; GRANT USAGE ON SCHEMA core TO APPLICATION ROLE app_public;
앱 설치 중에 설정 스크립트가 실행되면 이 문은 이름이
app_public
인 애플리케이션 역할을 생성합니다. 애플리케이션 역할은 데이터베이스 역할과 유사하지만, 앱의 컨텍스트 내에서만 사용할 수 있습니다. 컨슈머 계정에서 생성된 애플리케이션 오브젝트 내의 오브젝트에 대한 액세스 권한을 부여하는 데 사용됩니다.또한 이 예에서는 저장 프로시저를 포함할 스키마를 생성하고 애플리케이션 역할에 스키마에 대한 USAGE 권한을 부여합니다. 애플리케이션 역할을 생성하고 오브젝트(예: 스키마)에 대한 권한을 애플리케이션 역할에 부여하는 것은 설정 스크립트 내에서 일반적인 패턴입니다.
setup_script.sql
파일의 끝에 저장 프로시저의 코드를 추가합니다.CREATE OR REPLACE PROCEDURE CORE.HELLO() RETURNS STRING LANGUAGE SQL EXECUTE AS OWNER AS BEGIN RETURN 'Hello Snowflake!'; END;
이 예에서는 문자열 “Hello Snowflake!”를 출력하는 저장 프로시저를 만듭니다.
setup_script.sql
파일의 끝에 다음 문을 추가합니다.GRANT USAGE ON PROCEDURE core.hello() TO APPLICATION ROLE app_public;
이 예에서는 애플리케이션 역할에 저장 프로시저에 대한 USAGE 권한을 부여합니다.
이 섹션에서는 설정 스크립트에 저장 프로시저를 추가했습니다. 또한 애플리케이션 역할을 생성하고 이 역할에 USAGE 권한을 부여했습니다. 이렇게 하면 앱이 설치될 때 설정 스크립트가 저장 프로시저를 생성할 수 있습니다. 또한 이를 통해 앱에 저장 프로시저를 실행할 수 있는 권한을 부여합니다.
스테이지 개발 모드에서 앱 설치 및 테스트¶
이제 프로젝트 정의 파일에서 지정한 애플리케이션 패키지, 앱 및 기타 모든 엔터티를 만들 준비가 되었습니다.
이러한 작업을 수행하려면 다음 Snowflake CLI 명령을 실행합니다.
snow app run -c connection_name여기서
connection_name
은 Snowflake CLI를 설치할 때config.toml
파일에 지정한 연결의 이름입니다.
이 명령은 다음 작업을 수행합니다.
stage_content
스키마 및hello_snowflake_stage
스테이지를 사용하여 애플리케이션 패키지 이름hello_snowflake_package
를 생성합니다.필요한 모든 파일을 지정된 스테이지에 업로드합니다.
이 스테이지의 파일을 사용하여
hello_snowflake_app
앱을 생성하거나 업그레이드합니다.
명령이 성공적으로 실행되면 앱을 Snowsight 에서 볼 수 있는 URL을 출력합니다. 이전 섹션에서 setup_script.sql
에 추가한 HELLO
저장 프로시저를 실행하려면 다음 Snowflake CLI 명령을 실행합니다.
snow sql -q "call hello_snowflake_app.core.hello()" -c connection_name
이 명령을 실행하면 다음 출력이 표시됩니다.
+------------------+
| HELLO |
|------------------|
| Hello Snowflake! |
+------------------+
이 섹션에서 학습한 내용 복습하기¶
축하합니다! Snowflake Native App Framework 를 사용하여 첫 번째 Snowflake Native App 을 생성, 설치 및 테스트했습니다! 애플리케이션에는 기본적인 기능만 있지만, 애플리케이션을 만드는 데 사용한 구성 요소는 더 복잡한 애플리케이션에도 동일합니다.
이 섹션에서는 다음을 완료했습니다.
설정 스크립트에 저장 프로시저를 추가했습니다. 설정 스크립트는 앱이 컨슈머 계정에 설치되는 방식을 지정합니다. 이후 섹션에서는 데이터 콘텐츠 및 기타 유형의 앱 논리를 애플리케이션에 추가합니다.
Snowflake CLI를 사용하여 처음으로 앱을 배포했습니다.
저장 프로시저를 실행하여 설치된 앱을 테스트했습니다.
이후 섹션에서는 앱을 보고 테스트하는 다른 방법에 대해 알아봅니다.
앱에 데이터 콘텐츠 추가¶
이전 섹션에서는 앱에 애플리케이션 논리를 추가하는 방법을 보여주는 저장 프로시저가 포함된 앱을 만들었습니다.
이 섹션에서는 HELLO_SNOWFLAKE_PACKAGE
애플리케이션 패키지 내에 데이터베이스를 생성하고 이 데이터베이스를 엡과 공유할 권한을 부여하여 앱에 데이터 콘텐츠를 포함합니다.
데이터 콘텐츠에 액세스하기 위한 뷰 추가¶
이 섹션에서는 앱을 설치한 컨슈머가 이전 섹션에서 생성한 ACCOUNTS
테이블의 데이터에 액세스할 수 있는 뷰를 추가하도록 설정 스크립트를 업데이트합니다.
데이터 콘텐츠에 액세스하는 뷰를 추가하려면 다음을 수행하십시오.
뷰에 대한 스키마를 생성하려면 설정 스크립트에 다음을 추가하십시오.
CREATE OR ALTER VERSIONED SCHEMA code_schema; GRANT USAGE ON SCHEMA code_schema TO APPLICATION ROLE app_public;
이러한 문으로 뷰를 포함하고 스키마에 대해 USAGE 권한을 부여하도록 버전이 지정된 스키마를 생성합니다. Snowflake Native App Framework 는 버전이 지정된 스키마를 사용하여 다양한 버전의 저장 프로시저와 함수를 처리합니다.
뷰를 만들려면 설정 스크립트에 다음을 추가하십시오.
CREATE VIEW IF NOT EXISTS code_schema.accounts_view AS SELECT ID, NAME, VALUE FROM shared_data.accounts; GRANT SELECT ON VIEW code_schema.accounts_view TO APPLICATION ROLE app_public;
이러한 문으로
code_schema
스키마에 뷰를 생성하고 뷰에 대해 필요한 권한을 애플리케이션 역할에 부여합니다.이 업데이트된 설정 스크립트는 다음번에 Snowflake CLI를 사용하여 앱을 배포할 때 스테이지에도 업로드됩니다.
업데이트된 앱 테스트¶
이 하위 섹션에서는 앱을 업그레이드하고 설치된 앱 내의 뷰를 사용하여 예제 테이블을 쿼리합니다.
업데이트된 앱을 테스트하려면:
컨슈머 계정에 설치된 애플리케이션 패키지와 애플리케이션 오브젝트를 업데이트하려면 다음 명령을 실행합니다.
snow app run -c connection_name
여기서
connection_name
은 Snowflake CLI를 설치할 때config.toml
파일에 지정한 연결 이름입니다.이 작업을 수행하면 편집된 모든 파일이 스테이지에 업로드되고
scripts/shared_content.sql
스크립트가 실행되며 스테이지에서 해당 파일을 사용하여 앱이 업그레이드됩니다.뷰가 올바르게 동작하는지 확인하려면 다음 명령을 실행합니다.
snow sql -q "SELECT * FROM hello_snowflake_app.code_schema.accounts_view" -c connection_name
이 명령의 출력은 다음과 같아야 합니다.
+----+----------+-----------+ | ID | NAME | VALUE | |----+----------+-----------| | 1 | Joe | Snowflake | | 2 | Nima | Snowflake | | 3 | Sally | Snowflake | | 4 | Juan | Acme | +----+----------+-----------+
이 섹션에서 학습한 내용 복습하기¶
이 섹션에서는 다음 작업을 수행하여 앱에 공유 데이터 콘텐츠를 포함하는 방법을 알아봤습니다.
애플리케이션 패키지 내에서
ACCOUNTS
테이블을 생성하고 테이블에 데이터를 삽입했습니다.애플리케이션 패키지에
ACCOUNTS
테이블에 대한 참조 사용 권한을 부여했습니다.애플리케이션 패키지에서
ACCOUNTS
테이블을 참조하는 스키마와 뷰를 생성했습니다.애플리케이션 역할에 스키마에 대한 사용 권한을 부여했습니다.
애플리케이션 역할에 뷰에 대한 선택 권한을 부여했습니다.
또한 애플리케이션 설치 시 다음을 수행하도록 설정 스크립트를 업데이트했습니다.
앱이 예제 데이터에 액세스하는 데 사용하는 스키마와 뷰를 만들었습니다.
애플리케이션 역할에 스키마에 대한 사용 권한을 부여했습니다.
애플리케이션 역할에 뷰에 대한 선택 권한을 부여했습니다.
앱에 Python 코드 추가¶
이 섹션에서는 Python 코드를 추가하여 애플리케이션 논리를 향상함으로써 애플리케이션의 기능을 확장합니다. 이 섹션에서는 Python 코드를 다음으로 포함합니다.
설정 스크립트의 자체 포함 함수인 인라인 Python UDF.
설정 스크립트 외부의 Python 파일을 참조하는 Python UDF.
참고
이 섹션에서는 Python을 사용하는 예제를 소개하지만 Java와 JavaScript에도 동일한 기술을 적용할 수 있습니다.
인라인 Python 함수를 UDF(사용자 정의 함수)로 추가¶
이 섹션에서는 Python 함수를 UDF로 추가합니다.
앱에 Python UDF를 포함하려면 설정 파일에 다음 코드를 추가합니다.
CREATE OR REPLACE FUNCTION code_schema.addone(i int) RETURNS INT LANGUAGE PYTHON RUNTIME_VERSION = '3.11' HANDLER = 'addone_py' AS $$ def addone_py(i): return i+1 $$; GRANT USAGE ON FUNCTION code_schema.addone(int) TO APPLICATION ROLE app_public;
이러한 명령은 앱이 설치될 때 다음 작업을 수행합니다.
code_schema
라는 버전 지정 스키마를 생성합니다.APP_PUBLIC
애플리케이션 역할에 스키마에 대한 사용 권한을 부여합니다.code_schema
스키마에서ADDONE()
UDF를 만듭니다.APP_PUBLIC
애플리케이션 역할에 함수에 대한 사용 권한을 부여합니다.
위의 코드 예제에서 생성된 스키마는 버전이 지정된 스키마입니다. 사용자 정의 함수와 저장 프로시저는 일반 스키마 대신 버전이 지정된 스키마에서 정의해야 합니다. 이렇게 하면 앱 업그레이드가 동시 코드 실행을 방해하지 않습니다.
외부 Python 모듈 추가하기¶
앱에 외부 Python 모듈을 추가하려면 다음을 수행합니다.
설정 스크립트에 다음 Python 함수를 추가합니다.
CREATE or REPLACE FUNCTION code_schema.multiply(num1 float, num2 float) RETURNS float LANGUAGE PYTHON RUNTIME_VERSION = 3.9 IMPORTS = ('/python/hello_python.py') HANDLER='hello_python.multiply'; GRANT USAGE ON FUNCTION code_schema.multiply(FLOAT, FLOAT) TO APPLICATION ROLE app_public;
이전 예와 마찬가지로, 이러한 문으로 스키마에서 Python UDF를 생성하고 애플리케이션 역할에 함수에 대한 권한을 부여합니다. 그러나 이 예제에는 명명된 스테이지를 생성하여 이 스테이지에 포함시킬 외부 Python 파일을 참조하는 IMPORTS 절이 포함되어 있습니다
tutorial
폴더에서python
이라는 하위 폴더를 만듭니다.python
하위 폴더에서hello_python.py
라는 파일을 만듭니다.다음 코드를
hello_python.py
파일에 추가합니다.def multiply(num1, num2): return num1*num2
이 외부 파일에 정의된 함수는 설정 스크립트에 정의된 인라인 함수와 일치합니다.
프로젝트 정의 파일의 기존
artifacts
섹션에 다음을 추가합니다.- python/hello_python.py
이 섹션에서는 앱에 Python UDF를 추가했습니다. 이 UDF는 애플리케이션 패키지에서 참조할 수 있는 외부 Python 모듈을 가리킵니다.
업데이트된 앱 설치 및 테스트¶
앱을 설치하고 테스트하려면:
애플리케이션 패키지와 앱을 업데이트하려면 다음 명령을 실행합니다.
snow app run -c connection_name
여기서
connection_name
은 Snowflake CLI를 설치할 때config.toml
에 지정한 연결의 이름입니다.이 명령은 편집된 파일과 새 파일을 스테이지에 업로드하고, 스테이지에 있는 파일을 사용하여 앱을 업그레이드합니다.
Python 저장 프로시저를 테스트하려면 다음 명령을 실행하십시오.
snow sql -q "SELECT hello_snowflake_app.code_schema.addone(1)" -c connection_name
참조된 Python 함수를 테스트하려면 다음 명령을 실행하십시오.
snow sql -q "SELECT hello_snowflake_app.code_schema.multiply(1,2)" -c connection_name
이 섹션에서 학습한 내용 복습하기¶
이 섹션에서는 애플리케이션에 다음과 같은 새 기능을 추가했습니다.
인라인 UDF로 정의된 Python 함수.
외부 코드를 참조하는 UDF로 정의된 Python 함수.
또한 앱의 업데이트된 버전을 설치하고 각 함수를 실행하여 이러한 각 예제를 테스트했습니다.
앱에 Streamlit 앱 추가¶
이 섹션에서는 Streamlit 사용자 인터페이스를 추가하여 Snowflake Native App 을 완성합니다. Streamlit은 데이터 과학 및 머신 러닝 애플리케이션을 개발하기 위한 오픈 소스 Python 프레임워크입니다. 사용자 상호 작용 및 데이터 시각화를 추가하기 위해 앱 내에 Streamlit 앱을 포함할 수 있습니다.
Streamlit 앱 파일 만들기¶
Streamlit 앱을 만들려면 다음을 수행하십시오.
tutorial
폴더에서streamlit
이라는 하위 폴더를 만듭니다.streamlit
폴더에서hello_snowflake.py
라는 파일을 만듭니다.이 파일에 다음 코드를 추가합니다.
# Import python packages import streamlit as st from snowflake.snowpark import Session # Write directly to the app st.title("Hello Snowflake - Streamlit Edition") st.write( """The following data is from the accounts table in the application package. However, the Streamlit app queries this data from a view called code_schema.accounts_view. """ ) # Get the current credentials session = Session.builder.getOrCreate() # Create an example data frame data_frame = session.sql("SELECT * FROM code_schema.accounts_view") # Execute the query and convert it into a Pandas data frame queried_data = data_frame.to_pandas() # Display the Pandas data frame as a Streamlit data frame. st.dataframe(queried_data, use_container_width=True)
프로젝트 정의 파일의 기존
artifacts
섹션에 다음을 추가합니다.- streamlit/hello_snowflake.py
설정 스크립트에 Streamlit 오브젝트 추가하기¶
앱에서 Streamlit 오브젝트를 만들려면 다음을 수행합니다.
setup_script.sql
파일 끝에 다음 문을 추가하여 Streamlit 오브젝트를 생성합니다.CREATE STREAMLIT IF NOT EXISTS code_schema.hello_snowflake_streamlit FROM '/streamlit' MAIN_FILE = '/hello_snowflake.py' ;
이 문으로 코어 스키마에 STREAMLIT 오브젝트를 생성합니다.
setup_script.sql
파일 끝에 다음 문을 추가하여 APP_PUBLIC 역할이 Streamlit 오브젝트에 액세스할 수 있도록 허용합니다.GRANT USAGE ON STREAMLIT code_schema.hello_snowflake_streamlit TO APPLICATION ROLE app_public;
업데이트된 앱 설치¶
애플리케이션 패키지와 앱을 업데이트하려면 다음 명령을 실행합니다.
snow app run -c connection_name
여기서
connection_name
은 Snowflake CLI를 설치할 때config.toml
파일에 지정한 연결 이름입니다.이 명령은 편집된 파일과 새 파일을 스테이지에 업로드하고, 스테이지에 있는 해당 파일을 사용하여 앱을 업그레이드합니다. 그런 다음 이 명령이 출력하는 URL로 이동하여 새 Streamlit이 작동하는지 확인하고, 그곳에 도착하면 애플리케이션 이름 옆에 표시되는 HELLO_SNOWFLAKE_STREAMLIT 탭을 클릭합니다.
이 섹션에서 학습한 내용 복습하기¶
이 섹션에서는 다음을 수행하여 Snowflake Native App 에 Streamlit 앱을 추가했습니다.
Streamlit 라이브러리를 사용하여 사용자 인터페이스를 렌더링하는 Python 파일을 만들었습니다.
공유 데이터를 표시하는 Streamlit 앱을 Snowflake Native App 에 만들었습니다.
앱에 버전 추가¶
이전 섹션에서는 “스테이지별 개발” 모드를 사용하여 변경 사항을 적용했습니다. 스테이지 개발 모드를 사용하면 새로운 버전이나 패치를 만들지 않고도 앱 개발을 빠르게 반복할 수 있습니다. 그러나 애플리케이션 패키지를 목록에 추가하고 다른 Snowflake 사용자와 공유하려면 앱 버전을 만들어야 합니다.
이 섹션에서는 이 자습서에서 추가한 모든 기능을 포함하는 버전을 애플리케이션에 추가합니다.
HELLO_SNOWFLAKE_PACKAGE
애플리케이션 패키지에 버전을 추가하려면 다음 명령을 실행하십시오.snow app version create v1_0 -c connection_name
이 명령에서는 이전 섹션에서 명명된 스테이지에 업로드한 애플리케이션 파일을 기반으로 버전을 추가하도록 애플리케이션 패키지를 수정했습니다.
참고
VERSION에 지정된 값은 숫자 값이나 문자열이 아닌 레이블입니다.
참고
추가한 새 버전의 패치 번호는
0
에서 자동으로 생성됩니다. 어떤 버전에 대해 패치를 계속 추가함에 따라 번호가 자동으로 증가합니다. 하지만 새 버전(예:V1_1
)을 만들 때 해당 버전의 패치 번호는0
으로 재설정됩니다.버전이 애플리케이션 패키지에 추가되었는지 확인하려면 다음 명령을 실행하십시오.
snow app version list -c connection_name
이 명령은 다음 출력과 같이 버전에 대한 추가 정보를 표시합니다.
+---------+-------+-------+---------+-------------------------------+------------+-----------+-------------+-------+---------------+ | version | patch | label | comment | created_on | dropped_on | log_level | trace_level | state | review_status | |---------+-------+-------+---------+-------------------------------+------------+-----------+-------------+-------+---------------| | V1_0 | 0 | NULL | NULL | 2024-05-09 10:33:39.768 -0700 | NULL | OFF | OFF | READY | NOT_REVIEWED | +---------+-------+-------+---------+-------------------------------+------------+-----------+-------------+-------+---------------+
어떤 버전을 기반으로 앱을 설치하려면 다음 명령을 실행합니다.
snow app run --version V1_0 -c connection_name
기존 앱은 명명된 스테이지의 파일을 사용하여 생성되었으므로 버전을 사용하여 앱을 업그레이드하려면 기존 앱을 삭제하고 이 버전으로 다시 생성해야 합니다. 지시에 따라 ‘예’로 대답합니다.
이 섹션에서는 앱의 버전을 포함하도록 애플리케이션 패키지를 수정하고 버전이 지정된 개발 모드를 사용하여 애플리케이션 오브젝트를 다시 만들었습니다.
Snowsight에서 앱 보기¶
이 섹션에서는 Snowsight 에서 앱 확인해 봅니다. 이전 섹션에서는 SQL 문을 사용하여 앱에 대한 정보를 테스트하거나 찾았습니다. 하지만 Snowsight 에서 앱에 대한 정보를 볼 수도 있습니다. 배포된 Streamlit 앱을 볼 수도 있습니다.
Snowsight 에서 앱을 보려면 다음을 수행합니다.
Snowsight 에 로그인합니다.
다음을 수행하여 ACCOUNTADMIN 역할로 전환합니다.
탐색 메뉴에서 사용자 이름을 선택하여 계정 메뉴를 엽니다.
활성 역할을 선택합니다. 예: PUBLIC.
역할 선택기가 나타납니다.
ACCOUNTADMIN 역할을 선택합니다.
Data Products » Apps 를 선택합니다.
HELLO_SNOWFLAKE_APP
을 선택합니다.Read Me
탭에는 이전 섹션에서app/README.md
파일에 추가한 내용이 표시됩니다.Streamlit 앱을 보려면 HELLO_SNOWFLAKE_STREAMLIT 을 선택하십시오.
HELLO_SNOWFLAKE_DATA
데이터베이스의 내용은 Streamlit 데이터 프레임에 표시됩니다.워크시트에서 앱을 열려면 Projects » Worksheets 를 선택합니다.
워크시트 목록에서 HELLO_SNOWFLAKE_APP 을 선택합니다.
필요한 경우 앱을 설치한 웨어하우스를 선택합니다.
Snowflake 워크시트에서 SQL 명령을 사용하여 앱을 테스트할 수 있습니다. 예를 들어 이전 섹션에서 실행한 명령을 다시 실행하여 애플리케이션에 추가한 기능을 테스트할 수 있습니다.
LIST @hello_snowflake_package.stage_content.hello_snowflake_stage;
CALL core.hello();
SELECT * FROM code_schema.accounts_view;
SELECT code_schema.addone(10);
SELECT code_schema.multiply(2,3);
참고
Snowsight 에서 다른 페이지로 이동하면 이 워크시트에 추가한 모든 SQL 문이 손실됩니다.
참고
Snowflake CLI에서 snow app open
명령을 사용하여 앱의 사용자 인터페이스를 직접 볼 수도 있습니다. 이 명령은 시스템에 구성된 웹 브라우저에서 적절한 URL을 엽니다.
앱 게시 및 설치¶
이 섹션에서는 애플리케이션 패키지를 데이터 콘텐츠로 사용하는 비공개 목록을 생성하여 앱을 게시합니다. 목록을 생성한 후 다른 계정으로 로그인하여 목록을 설치합니다.
기본 릴리스 지시문 설정하기¶
애플리케이션 패키지에 대한 목록을 생성하려면 먼저 릴리스 지시문을 설정해야 합니다. 릴리스 지시문은 컨슈머가 사용할 수 있는 앱의 버전을 지정합니다.
이 자습서에서는 이전 섹션에서 추가한 버전을 사용하여 기본 릴리스 지시문을 설정합니다.
애플리케이션 패키지에 대한 기본 릴리스 지시문을 설정하려면 다음을 수행하십시오.
애플리케이션 패키지에 대해 정의된 버전과 패치를 보려면 다음 명령을 실행하십시오.
snow app version list -c connection_name
이 명령으로 애플리케이션 패키지에 대해 정의된 버전과 패치를 표시합니다.
기본 릴리스 지시문을 버전
v1_0
및 패치0
으로 설정하려면 다음 명령을 실행하십시오.snow sql -q "ALTER APPLICATION PACKAGE hello_snowflake_package SET DEFAULT RELEASE DIRECTIVE VERSION = v1_0 PATCH = 0"
이 명령의 출력은 다음 예에 나와 있습니다.
+-----------------------------------------------------------+ | status | |-----------------------------------------------------------| | Default release directive set to version 'V1_0', patch 0. | +-----------------------------------------------------------+
이 섹션에서는 애플리케이션 패키지에 어떤 버전과 패치가 있는지 확인했습니다. 이 정보를 사용하여 애플리케이션 패키지에 대한 기본 릴리스 지시문을 정의했습니다.
애플리케이션용 목록 만들기¶
이제 애플리케이션 패키지에 대한 릴리스 지시문을 지정했으므로 목록을 만들고 애플리케이션 패키지를 목록의 데이터 콘텐츠로 추가합니다. 이를 통해 다른 Snowflake 사용자와 앱을 공유하고 자신의 계정에 앱을 설치하고 사용할 수 있습니다.
앱용 목록을 만들려면 다음을 수행합니다.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Data Products » Provider Studio 를 선택합니다.
+ Listing 을 선택합니다. 목록 만들기 윈도우가 열립니다.
목록 이름을 입력합니다.
In the Who can discover the listing 섹션에서 Only specified consumers 를 선택하여 목록을 특정 계정과 비공개로 공유합니다.
+ Select 를 클릭하여 목록에 대한 애플리케이션 패키지를 선택합니다.
목록에 대한 설명을 입력합니다.
Add consumer accounts 섹션에서 목록에서 앱을 설치하는 컨슈머 경험을 테스트하기 위해 사용 중인 계정의 계정 식별자를 추가합니다.
이 섹션에서는 애플리케이션 패키지를 공유 데이터 콘텐츠로 포함하는 비공개 목록을 만들었습니다.
컨슈머 계정에 앱 설치¶
이 섹션에서는 이전 섹션에서 만든 목록과 연결된 앱을 설치합니다. 컨슈머가 자신의 계정에 앱을 설치하는 방법을 모방하는 다른 계정에 목록을 설치합니다.
목록에서 앱을 설치하려면 다음을 수행합니다.
Snowsight 에 로그인합니다.
탐색 메뉴에서 Data Products » Apps 를 선택합니다.
Recently shared with you 아래에서 목록의 타일을 선택합니다.
Get 을 선택합니다.
고객에게 표시되는 앱의 이름을 입력합니다. 이 자습서에서는 “Hello Snowflake App”을 사용합니다.
앱을 설치할 웨어하우스를 선택합니다.
Get 을 선택합니다.
Open 을 선택하여 목록을 보거나 Done 을 선택하여 종료합니다.
이 섹션에서는 다른 Snowflake 사용자와 앱을 공유할 수 있는 목록을 게시하고 설치하는 방법을 알아봤습니다.
자세히 알아보기¶
축하합니다! 이 자습서를 마쳤을 뿐만 아니라 Snowflake Native App Framework 를 사용하여 앱의 개발 및 게시 수명 주기를 거치며 실습해 보았습니다.
그 과정에서 다음 작업을 수행했습니다.
Snowflake Native App Framework 를 사용하여 앱을 빌드하기 위해 Snowsight 및 Snowflake CLI 를 사용했습니다.
Snowsight 에 대한 자세한 내용은 워크시트 시작하기 및 Snowsight에서 워크시트로 작업하기 섹션을 참조하십시오.
Snowflake CLI 의 Snowflake Native App 에 대한 자세한 내용은 Snowflake CLI 에서 Snowflake Native App 사용하기 섹션을 참조하십시오.
모든 앱에 필요한 매니페스트와 설정 스크립트를 만들었습니다.
자세한 내용은 애플리케이션 패키지의 매니페스트 파일 만들기 및 설정 스크립트 만들기 섹션을 참조하십시오.
애플리케이션 논리와 앱의 데이터 내용을 위한 컨테이너로 동작하는 애플리케이션 패키지를 만들었습니다.
자세한 내용은 애플리케이션 패키지 만들기 섹션을 참조하십시오.
Python으로 작성된 UDFs와 저장 프로시저를 사용하여 앱에 논리를 추가했습니다.
Snowflake Native App Framework 에서 저장 프로시저, UDFs, 외부 함수를 사용하는 방법에 대한 정보는 애플리케이션 패키지에 애플리케이션 논리 추가하기 섹션을 참조하십시오.
프로시저와 함수의 각 유형에 대한 일반적인 정보는 Snowpark API, 함수와 프로시저로 Snowflake 확장하기 및 외부 함수 쓰기 섹션을 참조하십시오.
앱에 공유 데이터 콘텐츠를 추가했습니다.
자세한 내용은 Snowflake Native App 에서 데이터 내용 공유 섹션을 참조하십시오.
앱에 Streamlit 앱을 포함했습니다.
자세한 내용은 Streamlit을 사용하여 앱에 프런트엔드 경험 추가하기 섹션을 참조하십시오.
Snowsight 에서 앱을 확인했습니다.
컨슈머로서 앱 작업하기 를 참조하십시오.
앱에 대한 비공개 목록을 생성하고 별도의 Snowflake 계정에 앱을 설치했습니다.
애플리케이션 패키지가 포함된 목록 게시에 대한 자세한 내용은 컨슈머와 앱 공유하기 를 참조하십시오.
컨슈머가 목록에서 앱을 설치하는 방법에 대한 정보는 목록에서 앱 설치하기 를 참조하십시오.