Snowflake Native App 아티팩트가 구성된 로컬 폴더 준비하기¶

아티팩트가 구성된 로컬 폴더 만들기¶

snow app bundle 명령은 프로젝트에 로컬 디렉터리를 생성하고, 프로젝트 정의 파일에서 지정한 파일 구조로 채우고, 데코레이터(예: @sproc 또는 @udaf)가 포함된 Snowpark Python의 Snowflake Native App 설정 스크립트에서 CREATE FUNCTION 또는 CREATE PROCEDURE 선언을 생성합니다. 자세한 내용은 snowflake.snowpark.functions.udaf 등과 같이 선택한 함수 데코레이터에 해당하는 Snowpark Python 설명서를 참조하십시오.

snow app deploy 및 snow app run 명령은 이미 이 기능을 사용합니다. 하지만 이제 명시적인 snow app bundle 명령을 사용하면 스테이지에 업로드되기 전에 이 디렉터리를 탐색하여 아티팩트가 예상대로 생성되었는지 확인할 수 있습니다.

아티팩트가 구성된 로컬 폴더를 생성하려면 다음을 수행하십시오.

1. Snowflake snowflake.yml 프로젝트 정의 파일을 생성하거나 확인합니다. 예:

   definition_version: 2
   entities:
     codegen_nativeapp_pkg:
       type: application package
       manifest: root_files/_manifest.yml
       artifacts:
         - src: root_files/README.md
           dest: README.md
         - src: root_files/_manifest.yml
           dest: manifest.yml
         - src: root_files/setup_scripts/*
           dest: setup_scripts/
         - src: python/user_gen/echo.py
           dest: user_gen/echo.py
         - src: python/cli_gen/*
           dest: cli_gen/
           processors:
             - snowpark
     codegen_nativeapp_pkg:
       type: application
       from:
         target: codegen_nativeapp_pkg
   

   Copy

2. 프로젝트 디렉터리에서 snow app bundle 명령을 실행하여 구성된 아티팩트가 포함된 임시 output/deploy 디렉터리를 생성합니다.

   snow app bundle
   

   Copy

3. 출력 또는 배포 디렉터리의 내용이 snowdropper.yml 파일에서 지정한 규칙과 일치하는지 확인합니다. Python 파일에서 Snowpark 주석 처리를 호출하면 디렉터리의 수정된 설정 스크립트에서 생성된 코드를 볼 수 있습니다.

자세한 내용은 snow app bundle 명령을 참조하십시오.

Snowpark 주석 처리를 사용하여 SQL 코드 생성하기¶

SQL 배경 지식이 부족한 Snowflake Native App 개발자는 시간이 지남에 따라 상당히 크고 복잡해질 수 있는 설정 스크립트 를 작성하고 유지 관리하는 것이 번거로울 수 있습니다. 설정 스크립트에는 고객이 자체 데이터와 함께 사용할 수 있는 모든 애플리케이션 로직이 포함되어 있으므로 Snowflake Native App을 개발하는 데 필수적인 부분입니다. 설정 스크립트의 핵심 구성 요소 중 하나는 함수와 저장 프로시저에 Snowpark Python 확장 프로그램 함수를 사용할 수 있는 기능입니다. Python, Java 또는 기타 Snowpark 지원 언어로 Snowpark 코드를 작성하는 것 외에도 설정 스크립트에서 SQL을 사용하여 해당 함수 및 프로시저의 해당 부분을 작성해야 합니다.

예를 들어, Snowpark Python을 사용하여 다음과 같이 기본 함수와 저장 프로시저를 생성할 수 있습니다.

# Example python file "echo.py" that a developer writes

def echo_fn(data):
    return 'echo_fn: ' + data

def echo_proc(session, data):
    return 'echo_proc: ' + data

그런 다음 파일을 스테이지에 업로드하고 다음과 같이 설정 스크립트 SQL 코드에서 참조해야 합니다.

-- Sample setup_script.sql SQL file for a Snowflake Native App

CREATE APPLICATION ROLE IF NOT EXISTS app_instance_role;

CREATE OR ALTER VERSIONED SCHEMA ext_code_schema;
GRANT USAGE ON SCHEMA ext_code_schema TO APPLICATION ROLE app_instance_role;

CREATE OR REPLACE PROCEDURE ext_code_schema.py_echo_proc(DATA string)
  RETURNS STRING
  LANGUAGE PYTHON
  RUNTIME_VERSION = 3.9
  PACKAGES=('snowflake-snowpark-python')
  HANDLER='echo.echo_proc'
  IMPORTS=('/echo.py');

    GRANT USAGE ON PROCEDURE ext_code_schema.py_echo_proc(string)
      TO APPLICATION ROLE app_instance_role;

-- Wraps a function from a python file
CREATE OR REPLACE FUNCTION ext_code_schema.py_echo_fn(string)
RETURNS STRING
LANGUAGE PYTHON
RUNTIME_VERSION = 3.9
PACKAGES=('snowflake-snowpark-python')
HANDLER='echo.echo_fn'
IMPORTS=('/echo.py');

GRANT USAGE ON FUNCTION ext_code_schema.py_echo_fn(DATA string)
  TO APPLICATION ROLE app_instance_role;

# some python file echo.py
@udf(name="echo_fn")
def echo_fn(data) -> str:
  return 'echo_fn: ' + str

-- Sample setup_script.sql SQL file for a Snowflake Native App

-- User-written code
CREATE OR REPLACE APPLICATION ROLE app_instance_role;

CREATE OR ALTER VERSIONED SCHEMA ext_code_schema;
GRANT USAGE ON SCHEMA ext_code_schema TO APPLICATION ROLE app_instance_role;

-- Snowflake CLI generated code
CREATE OR REPLACE FUNCTION ext_code_schema.py_echo_fn(DATA string)
  RETURNS STRING
  LANGUAGE PYTHON
  RUNTIME_VERSION = 3.9
  PACKAGES=('snowflake-snowpark-python')
  HANDLER='echo.echo_fn'
  IMPORTS=('/echo.py');

  GRANT USAGE ON FUNCTION ext_code_schema.py_echo_fn(string)
    TO APPLICATION ROLE app_instance_role;

Snowpark Python 데코레이터 사용하기¶

Snowflake CLI 의 Snowpark 데코레이터는 일반 Snowpark Python 데코레이터와 동일하게 작동하지만, Snowflake Native App 용으로 특별히 Python 코드 파일을 작성할 때는 다음과 같은 차이점을 알고 있어야 합니다.

• Snowflake CLI 는 Snowflake에 연결되지 않은 샌드박스 환경에서 이러한 Python 파일을 실행하므로 이러한 파일에서는 Session 오브젝트를 사용할 수 없습니다. 그 결과, Snowpark Session 을 참조하면 오류가 발생합니다.

• @udf, @sproc, @udaf, @udtf Snowpark Python 데코레이터만 사용할 수 있습니다.

• 이러한 데코레이터를 일반 함수로 사용하여 코드를 Snowflake 오브젝트로 등록할 수 없습니다. 지원되는 데코레이터로 명시적으로 주석이 달린 코드만 인식됩니다. 따라서 Python 함수는 명명된 함수여야 합니다. Lambda 함수는 지원되지 않습니다.

• Snowflake CLI 는 설정 스크립트에서 함수와 절차를 생성할 때 항상 Snowflake에서 권장하는 대로 CREATE OR REPLACE 문을 생성합니다.

# output/deploy/dest_dir1/dest_dir2/echo.py
#: @sproc(
#:    return_type=IntegerType(),
#:    input_types=[IntegerType(), IntegerType()],
#:    packages=["snowflake-snowpark-python==1.15.0"],
#:    native_app_params={
#:        "schema": "ext_code_schema",
#:        "application_roles": ["app_instance_role"],
#:    },
#: )
def add_sp(session_, x, y):
    return x + y