자습서: Snowflake Native App Framework를 사용하여 Snowflake Native App 개발¶

알아볼 내용¶

이 자습서에서는 다음에 대해 설명합니다.

• 애플리케이션의 데이터 및 비즈니스 논리를 포함하는 애플리케이션 패키지를 생성합니다.

• 애플리케이션 패키지와 데이터를 공유합니다.

• 애플리케이션 패키지에 비즈니스 논리를 추가합니다.

• 애플리케이션을 로컬에서 테스트합니다.

• 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 CLI 를 사용하여 로컬 파일시스템에 새 Snowflake Native App 프로젝트를 초기화합니다.

이를 수행하려면 다음 명령을 실행합니다.

snow init --template app_basic tutorial

Copy

이 명령은 현재 작업 디렉터리 안에 이름이 tutorial 인 폴더를 생성하고 기본 템플릿을 기반으로 기본 Snowflake Native App 프로젝트로 채웁니다. 이 디렉터리는 모든 애플리케이션 파일의 루트 디렉터리입니다.

설정 스크립트 만들기¶

다음 예제와 같이 app/setup_script.sql 파일의 내용을 수정하거나 바꿉니다.

-- Setup script for the Hello Snowflake! app.

Copy

설정 스크립트를 비워둘 수 없으므로 이 줄은 자리 표시자입니다.

참고

이 자습서에서는 설정 스크립트에 대한 특정 구조와 파일 이름을 참조하십시오. 하지만 자체 애플리케이션을 만들 때 이 파일의 고유한 이름과 디렉터리 구조를 선택할 수 있습니다.

애플리케이션용 README 파일 만들기¶

추가 정보 파일에는 애플리케이션이 수행하는 작업에 대한 설명이 나와 있습니다. Snowsight 에서 애플리케이션을 볼 때 추가 정보가 표시됩니다.

app/README.md 의 내용을 다음과 같이 수정하거나 바꿉니다.

This is the readme file for the Hello Snowflake app.

Copy

매니페스트 파일 만들기¶

Snowflake Native App Framework 에는 각 앱에 대한 매니페스트 파일이 필요합니다. 매니페스트 파일에는 앱에 대한 메타데이터와 구성 매개 변수가 포함되어 있으며 앱의 런타임 동작에 영향을 미칩니다.

app/manifest.yml 의 내용을 다음과 같이 수정하거나 바꿉니다.

manifest_version: 1
artifacts:
   setup_script: setup_script.sql
   readme: README.md

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

Copy

이 자습서의 다음 섹션에서는 이러한 각 속성을 사용하는 방법을 설명합니다.

이 섹션에서 학습한 내용 복습하기¶

이 섹션의 단계를 수행한 후에는 이제 다음과 같은 디렉터리 구조가 있어야 합니다.

/tutorial
  snowflake.yml
  README.md
  /app/
    manifest.yml
    README.md
    setup_script.sql

이 섹션에서는 Snowflake Native App Framework 에 필요한 설정 스크립트 및 매니페스트 파일과 Snowflake CLI에 필요한 프로젝트 정의 파일을 생성하는 방법을 알아봤습니다.

설정 스크립트와 매니페스트 파일에 추가한 내용은 기본이지만 모든 앱에는 이러한 파일이 있어야 합니다.

또한 Snowsight 에서 앱을 볼 때 또는 앱을 목록으로 게시할 때 표시되는 readme 파일을 추가했습니다.

설정 스크립트에 저장 프로시저 추가하기¶

이 섹션에서는 로컬 파일 시스템의 설정 스크립트에 저장 프로시저의 코드를 추가하여 애플리케이션에 저장 프로시저를 추가합니다.

설정 스크립트에 저장 프로시저를 추가하려면 다음을 수행하십시오.

1. 이 자습서의 이전 섹션에서 만든 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;
   

   Copy

   앱 설치 중에 설정 스크립트가 실행되면 이 문은 이름이 app_public 인 애플리케이션 역할을 생성합니다. 애플리케이션 역할은 데이터베이스 역할과 유사하지만, 앱의 컨텍스트 내에서만 사용할 수 있습니다. 컨슈머 계정에서 생성된 애플리케이션 오브젝트 내의 오브젝트에 대한 액세스 권한을 부여하는 데 사용됩니다.

   또한 이 예에서는 저장 프로시저를 포함할 스키마를 생성하고 애플리케이션 역할에 스키마에 대한 USAGE 권한을 부여합니다. 애플리케이션 역할을 생성하고 오브젝트(예: 스키마)에 대한 권한을 애플리케이션 역할에 부여하는 것은 설정 스크립트 내에서 일반적인 패턴입니다.

2. setup_script.sql 파일의 끝에 저장 프로시저의 코드를 추가합니다.

   CREATE OR REPLACE PROCEDURE CORE.HELLO()
     RETURNS STRING
     LANGUAGE SQL
     EXECUTE AS OWNER
     AS
     BEGIN
       RETURN 'Hello Snowflake!';
     END;
   

   Copy

   이 예에서는 문자열 “Hello Snowflake!”를 출력하는 저장 프로시저를 만듭니다.

3. setup_script.sql 파일의 끝에 다음 문을 추가합니다.

   GRANT USAGE ON PROCEDURE core.hello() TO APPLICATION ROLE app_public;
   

   Copy

   이 예에서는 애플리케이션 역할에 저장 프로시저에 대한 USAGE 권한을 부여합니다.

이 섹션에서는 설정 스크립트에 저장 프로시저를 추가했습니다. 또한 애플리케이션 역할을 생성하고 이 역할에 USAGE 권한을 부여했습니다. 이렇게 하면 앱이 설치될 때 설정 스크립트가 저장 프로시저를 생성할 수 있습니다. 또한 이를 통해 앱에 저장 프로시저를 실행할 수 있는 권한을 부여합니다.

스테이지 개발 모드에서 앱 설치 및 테스트¶

이제 프로젝트 정의 파일에서 지정한 애플리케이션 패키지, 앱 및 기타 모든 엔터티를 만들 준비가 되었습니다.

이러한 작업을 수행하려면 다음 Snowflake CLI 명령을 실행합니다.

snow app run -c connection_name

Copy

여기서 connection_name 은 Snowflake CLI를 설치할 때 config.toml 파일에 지정한 연결의 이름입니다.

이 명령은 다음 작업을 수행합니다.

1. stage_content 스키마 및 hello_snowflake_stage 스테이지를 사용하여 애플리케이션 패키지 이름 hello_snowflake_package 를 생성합니다.

2. 필요한 모든 파일을 지정된 스테이지에 업로드합니다.

3. 이 스테이지의 파일을 사용하여 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를 사용하여 처음으로 앱을 배포했습니다.

• 저장 프로시저를 실행하여 설치된 앱을 테스트했습니다.

이후 섹션에서는 앱을 보고 테스트하는 다른 방법에 대해 알아봅니다.

앱과 공유할 테이블 만들기¶

이 섹션에서는 앱과 데이터 콘텐츠를 공유하는 방법을 알아봅니다. 구체적으로, 애플리케이션 패키지에 스키마와 테이블에 대한 권한을 부여하여 공급자 계정에서 테이블을 공유합니다.

1. 테이블을 만들고 애플리케이션 패키지에 샘플 데이터를 삽입하려면 폴더 tutorial/scripts 를 만든 다음 폴더 안에 파일 shared_content.sql 을 만듭니다. 이 파일에 다음 내용을 추가합니다.

   USE APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   
   CREATE SCHEMA IF NOT EXISTS shared_data;
   USE SCHEMA shared_data;
   CREATE TABLE IF NOT EXISTS accounts (ID INT, NAME VARCHAR, VALUE VARCHAR);
   TRUNCATE TABLE accounts;
   INSERT INTO accounts VALUES
     (1, 'Joe', 'Snowflake'),
     (2, 'Nima', 'Snowflake'),
     (3, 'Sally', 'Snowflake'),
     (4, 'Juan', 'Acme');
   -- grant usage on the ``ACCOUNTS`` table
   GRANT USAGE ON SCHEMA shared_data TO SHARE IN APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   GRANT SELECT ON TABLE accounts TO SHARE IN APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   

   Copy

   이 예제에서 <% ctx.entities.hello_snowflake_package.identifier %> 는 Snowflake CLI 명령을 실행할 때 snowflake.yml 파일에서 확인된 application package 의 식별자로 대체되는 템플릿입니다.

   애플리케이션 패키지 내의 오브젝트에 이러한 권한을 부여하면 이 애플리케이션 패키지에서 생성된 모든 오브젝트에서 shared_data.accounts 테이블을 사용할 수 있습니다. 이 공유는 스크립트 끝에 있는 권한 GRANT TO SHARE 명령으로 인해 수행됩니다.

   참고

   앱에서 컨슈머와 공유하려는 각 스키마에 대한 애플리케이션 패키지에 각 스키마에 대한 USAGE 권한을 부여해야 합니다. 그런 다음 공유하려는 스키마 내의 오브젝트에 대해 SELECT 권한을 부여해야 합니다.

2. 애플리케이션 패키지를 업데이트할 때 이 스크립트가 실행되도록 프로젝트 정의 파일에 항목을 추가합니다. 최종 프로젝트 정의 파일은 다음과 같습니다.

   definition_version: 2
   entities:
      hello_snowflake_package:
         type: application package
         stage: stage_content.hello_snowflake_stage
         manifest: app/manifest.yml
         artifacts:
            - src: app/*
              dest: ./
         meta:
            post_deploy:
               - sql_script: scripts/shared_content.sql
      hello_snowflake_app:
         type: application
         from:
            target: hello_snowflake_package
         debug: false
   

   Copy

데이터 콘텐츠에 액세스하기 위한 뷰 추가¶

이 섹션에서는 앱을 설치한 컨슈머가 이전 섹션에서 생성한 ACCOUNTS 테이블의 데이터에 액세스할 수 있는 뷰를 추가하도록 설정 스크립트를 업데이트합니다.

데이터 콘텐츠에 액세스하는 뷰를 추가하려면 다음을 수행하십시오.

1. 뷰에 대한 스키마를 생성하려면 설정 스크립트에 다음을 추가하십시오.

   CREATE OR ALTER VERSIONED SCHEMA code_schema;
   GRANT USAGE ON SCHEMA code_schema TO APPLICATION ROLE app_public;
   

   Copy

   이러한 문으로 뷰를 포함하고 스키마에 대해 USAGE 권한을 부여하도록 버전이 지정된 스키마를 생성합니다. Snowflake Native App Framework 는 버전이 지정된 스키마를 사용하여 다양한 버전의 저장 프로시저와 함수를 처리합니다.

2. 뷰를 만들려면 설정 스크립트에 다음을 추가하십시오.

   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;
   

   Copy

   이러한 문으로 code_schema 스키마에 뷰를 생성하고 뷰에 대해 필요한 권한을 애플리케이션 역할에 부여합니다.

   이 업데이트된 설정 스크립트는 다음번에 Snowflake CLI를 사용하여 앱을 배포할 때 스테이지에도 업로드됩니다.

업데이트된 앱 테스트¶

이 하위 섹션에서는 앱을 업그레이드하고 설치된 앱 내의 뷰를 사용하여 예제 테이블을 쿼리합니다.

업데이트된 앱을 테스트하려면:

1. 컨슈머 계정에 설치된 애플리케이션 패키지와 애플리케이션 오브젝트를 업데이트하려면 다음 명령을 실행합니다.

   snow app run -c connection_name
   

   Copy

   여기서 connection_name 은 Snowflake CLI를 설치할 때 config.toml 파일에 지정한 연결 이름입니다.

   이 작업을 수행하면 편집된 모든 파일이 스테이지에 업로드되고 scripts/shared_content.sql 스크립트가 실행되며 스테이지에서 해당 파일을 사용하여 앱이 업그레이드됩니다.

2. 뷰가 올바르게 동작하는지 확인하려면 다음 명령을 실행합니다.

   snow sql -q "SELECT * FROM hello_snowflake_app.code_schema.accounts_view" -c connection_name
   

   Copy

   이 명령의 출력은 다음과 같아야 합니다.

   +----+----------+-----------+
   | ID | NAME     | VALUE     |
   |----+----------+-----------|
   |  1 | Joe      | Snowflake |
   |  2 | Nima     | Snowflake |
   |  3 | Sally    | Snowflake |
   |  4 | Juan     | Acme      |
   +----+----------+-----------+
   

   Copy

이 섹션에서 학습한 내용 복습하기¶

이 섹션에서는 다음 작업을 수행하여 앱에 공유 데이터 콘텐츠를 포함하는 방법을 알아봤습니다.

• 애플리케이션 패키지 내에서 ACCOUNTS 테이블을 생성하고 테이블에 데이터를 삽입했습니다.

• 애플리케이션 패키지에 ACCOUNTS 테이블에 대한 참조 사용 권한을 부여했습니다.

• 애플리케이션 패키지에서 ACCOUNTS 테이블을 참조하는 스키마와 뷰를 생성했습니다.

• 애플리케이션 역할에 스키마에 대한 사용 권한을 부여했습니다.

• 애플리케이션 역할에 뷰에 대한 선택 권한을 부여했습니다.

또한 애플리케이션 설치 시 다음을 수행하도록 설정 스크립트를 업데이트했습니다.

• 앱이 예제 데이터에 액세스하는 데 사용하는 스키마와 뷰를 만들었습니다.

• 애플리케이션 역할에 스키마에 대한 사용 권한을 부여했습니다.

• 애플리케이션 역할에 뷰에 대한 선택 권한을 부여했습니다.

인라인 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;

Copy

이러한 명령은 앱이 설치될 때 다음 작업을 수행합니다.

• code_schema 라는 버전 지정 스키마를 생성합니다.

• APP_PUBLIC 애플리케이션 역할에 스키마에 대한 사용 권한을 부여합니다.

• code_schema 스키마에서 ADDONE() UDF를 만듭니다.

• APP_PUBLIC 애플리케이션 역할에 함수에 대한 사용 권한을 부여합니다.

위의 코드 예제에서 생성된 스키마는 버전이 지정된 스키마입니다. 사용자 정의 함수와 저장 프로시저는 일반 스키마 대신 버전이 지정된 스키마에서 정의해야 합니다. 이렇게 하면 앱 업그레이드가 동시 코드 실행을 방해하지 않습니다.

외부 Python 모듈 추가하기¶

앱에 외부 Python 모듈을 추가하려면 다음을 수행합니다.

1. 설정 스크립트에 다음 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;
   

   Copy

   이전 예와 마찬가지로, 이러한 문으로 스키마에서 Python UDF를 생성하고 애플리케이션 역할에 함수에 대한 권한을 부여합니다. 그러나 이 예제에는 명명된 스테이지를 생성하여 이 스테이지에 포함시킬 외부 Python 파일을 참조하는 IMPORTS 절이 포함되어 있습니다

2. tutorial 폴더에서 python 이라는 하위 폴더를 만듭니다.

3. python 하위 폴더에서 hello_python.py 라는 파일을 만듭니다.

4. 다음 코드를 hello_python.py 파일에 추가합니다.

   def multiply(num1, num2):
     return num1*num2
   

   Copy

   이 외부 파일에 정의된 함수는 설정 스크립트에 정의된 인라인 함수와 일치합니다.

5. 프로젝트 정의 파일의 기존 artifacts 섹션에 다음을 추가합니다.

   - python/hello_python.py
   

   Copy

이 섹션에서는 앱에 Python UDF를 추가했습니다. 이 UDF는 애플리케이션 패키지에서 참조할 수 있는 외부 Python 모듈을 가리킵니다.

업데이트된 앱 설치 및 테스트¶

앱을 설치하고 테스트하려면:

1. 애플리케이션 패키지와 앱을 업데이트하려면 다음 명령을 실행합니다.

   snow app run -c connection_name
   

   Copy

   여기서 connection_name 은 Snowflake CLI를 설치할 때 config.toml 에 지정한 연결의 이름입니다.

   이 명령은 편집된 파일과 새 파일을 스테이지에 업로드하고, 스테이지에 있는 파일을 사용하여 앱을 업그레이드합니다.

2. Python 저장 프로시저를 테스트하려면 다음 명령을 실행하십시오.

   snow sql -q "SELECT hello_snowflake_app.code_schema.addone(1)" -c connection_name
   

   Copy

3. 참조된 Python 함수를 테스트하려면 다음 명령을 실행하십시오.

   snow sql -q "SELECT hello_snowflake_app.code_schema.multiply(1,2)" -c connection_name
   

   Copy

이 섹션에서 학습한 내용 복습하기¶

이 섹션에서는 애플리케이션에 다음과 같은 새 기능을 추가했습니다.

• 인라인 UDF로 정의된 Python 함수.

• 외부 코드를 참조하는 UDF로 정의된 Python 함수.

또한 앱의 업데이트된 버전을 설치하고 각 함수를 실행하여 이러한 각 예제를 테스트했습니다.

Streamlit 앱 파일 만들기¶

Streamlit 앱을 만들려면 다음을 수행하십시오.

1. tutorial 폴더에서 streamlit 이라는 하위 폴더를 만듭니다.

2. streamlit 폴더에서 hello_snowflake.py 라는 파일을 만듭니다.

3. 이 파일에 다음 코드를 추가합니다.

   # 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)
   

   Copy

4. 프로젝트 정의 파일의 기존 artifacts 섹션에 다음을 추가합니다.

   - streamlit/hello_snowflake.py
   

   Copy

설정 스크립트에 Streamlit 오브젝트 추가하기¶

앱에서 Streamlit 오브젝트를 만들려면 다음을 수행합니다.

1. setup_script.sql 파일 끝에 다음 문을 추가하여 Streamlit 오브젝트를 생성합니다.

   CREATE STREAMLIT IF NOT EXISTS code_schema.hello_snowflake_streamlit
     FROM '/streamlit'
     MAIN_FILE = '/hello_snowflake.py'
   ;
   

   Copy

   이 문으로 코어 스키마에 STREAMLIT 오브젝트를 생성합니다.

2. setup_script.sql 파일 끝에 다음 문을 추가하여 APP_PUBLIC 역할이 Streamlit 오브젝트에 액세스할 수 있도록 허용합니다.

   GRANT USAGE ON STREAMLIT code_schema.hello_snowflake_streamlit TO APPLICATION ROLE app_public;
   

   Copy

업데이트된 앱 설치¶

1. 애플리케이션 패키지와 앱을 업데이트하려면 다음 명령을 실행합니다.

   snow app run -c connection_name
   

   Copy

   여기서 connection_name 은 Snowflake CLI를 설치할 때 config.toml 파일에 지정한 연결 이름입니다.

   이 명령은 편집된 파일과 새 파일을 스테이지에 업로드하고, 스테이지에 있는 해당 파일을 사용하여 앱을 업그레이드합니다. 그런 다음 이 명령이 출력하는 URL로 이동하여 새 Streamlit이 작동하는지 확인하고, 그곳에 도착하면 애플리케이션 이름 옆에 표시되는 HELLO_SNOWFLAKE_STREAMLIT 탭을 클릭합니다.

이 섹션에서 학습한 내용 복습하기¶

이 섹션에서는 다음을 수행하여 Snowflake Native App 에 Streamlit 앱을 추가했습니다.

• Streamlit 라이브러리를 사용하여 사용자 인터페이스를 렌더링하는 Python 파일을 만들었습니다.

• 공유 데이터를 표시하는 Streamlit 앱을 Snowflake Native App 에 만들었습니다.

기본 릴리스 지시문 설정하기¶

애플리케이션 패키지에 대한 목록을 생성하려면 먼저 릴리스 지시문을 설정해야 합니다. 릴리스 지시문은 컨슈머가 사용할 수 있는 앱의 버전을 지정합니다.

이 자습서에서는 이전 섹션에서 추가한 버전을 사용하여 기본 릴리스 지시문을 설정합니다.

애플리케이션 패키지에 대한 기본 릴리스 지시문을 설정하려면 다음을 수행하십시오.

1. 애플리케이션 패키지에 대해 정의된 버전과 패치를 보려면 다음 명령을 실행하십시오.

   snow app version list -c connection_name
   

   Copy

   이 명령으로 애플리케이션 패키지에 대해 정의된 버전과 패치를 표시합니다.

2. 기본 릴리스 지시문을 버전 v1_0 및 패치 0 으로 설정하려면 다음 명령을 실행하십시오.

   snow sql -q "ALTER APPLICATION PACKAGE hello_snowflake_package SET DEFAULT RELEASE DIRECTIVE VERSION = v1_0 PATCH = 0"
   

   Copy

   이 명령의 출력은 다음 예에 나와 있습니다.

   +-----------------------------------------------------------+
   | status                                                    |
   |-----------------------------------------------------------|
   | Default release directive set to version 'V1_0', patch 0. |
   +-----------------------------------------------------------+
   

   Copy

이 섹션에서는 애플리케이션 패키지에 어떤 버전과 패치가 있는지 확인했습니다. 이 정보를 사용하여 애플리케이션 패키지에 대한 기본 릴리스 지시문을 정의했습니다.

애플리케이션용 목록 만들기¶

이제 애플리케이션 패키지에 대한 릴리스 지시문을 지정했으므로 목록을 만들고 애플리케이션 패키지를 목록의 데이터 콘텐츠로 추가합니다. 이를 통해 다른 Snowflake 사용자와 앱을 공유하고 자신의 계정에 앱을 설치하고 사용할 수 있습니다.

앱용 목록을 만들려면 다음을 수행합니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Data Products » Provider Studio 를 선택합니다.

3. + Listing 을 선택합니다. 목록 만들기 윈도우가 열립니다.

4. 목록 이름을 입력합니다.

5. In the Who can discover the listing 섹션에서 Only specified consumers 를 선택하여 목록을 특정 계정과 비공개로 공유합니다.

6. + Select 를 클릭하여 목록에 대한 애플리케이션 패키지를 선택합니다.

7. 목록에 대한 설명을 입력합니다.

8. Add consumer accounts 섹션에서 목록에서 앱을 설치하는 컨슈머 경험을 테스트하기 위해 사용 중인 계정의 계정 식별자를 추가합니다.

이 섹션에서는 애플리케이션 패키지를 공유 데이터 콘텐츠로 포함하는 비공개 목록을 만들었습니다.

컨슈머 계정에 앱 설치¶

이 섹션에서는 이전 섹션에서 만든 목록과 연결된 앱을 설치합니다. 컨슈머가 자신의 계정에 앱을 설치하는 방법을 모방하는 다른 계정에 목록을 설치합니다.

목록에서 앱을 설치하려면 다음을 수행합니다.

1. Snowsight 에 로그인합니다.

2. 탐색 메뉴에서 Data Products » Apps 를 선택합니다.

3. Recently shared with you 아래에서 목록의 타일을 선택합니다.

4. Get 을 선택합니다.

5. 고객에게 표시되는 앱의 이름을 입력합니다. 이 자습서에서는 “Hello Snowflake App”을 사용합니다.

6. 앱을 설치할 웨어하우스를 선택합니다.

7. Get 을 선택합니다.

8. Open 을 선택하여 목록을 보거나 Done 을 선택하여 종료합니다.

이 섹션에서는 다른 Snowflake 사용자와 앱을 공유할 수 있는 목록을 게시하고 설치하는 방법을 알아봤습니다.