Snowpark 프로젝트 정의 만들기¶

식별자

선택 사항, 문자열

엔터티에 대한 선택적 Snowflake 식별자입니다. 값은 다음 형식일 수 있습니다.

• 문자열 식별자 텍스트

  identifier: my-snowpark-id
  

  Copy

  따옴표로 묶지 않은 식별자와 따옴표로 묶은 식별자가 모두 지원됩니다. 따옴표로 묶인 식별자를 사용하려면 YAML 값에 따옴표(예: ’”My Snowpark Function”’)를 포함합니다.

• 오브젝트

  identifier:
    name: my-snowpark-id
    schema: my-schema # optional
    database: my-db # optional
  

  Copy

  참고

  schema 또는 database 를 지정하고 name 속성에 정규화된 이름(예: mydb.schema1.my-app)을 사용하면 오류가 발생합니다.

artifact_repository

선택 사항, 문자열

아티팩트 리포지토리의 이름입니다. Snowflake에는 Snowpark UDF 및 프로시저 내에서 PyPI 패키지를 연결하고 설치하는 데 사용하는 snowflake.snowpark.pypi_shared_repository 라는 기본 아티팩트 리포지토리가 있습니다. 자세한 내용은 아티팩트 리포지토리 개요 섹션을 참조하십시오.

artifact_repository 및 packages 매개 변수를 사용하면 다음과 유사하게 anaconda가 아닌 패키지를 사용할 수 있습니다.

• 프로젝트의 app.py 파일에서 다음과 같은 함수를 정의할 수 있습니다.

  from sklearn.datasets import load_iris
  from sklearn.model_selection import train_test_split
  from sklearn.ensemble import RandomForestClassifier
  
  def udf():
    X, y = load_iris(return_X_y=True)
    X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.25, random_state=42)
  
    model = RandomForestClassifier()
    model.fit(X_train, y_train)
    return model.score(X_test, y_test)
  

  Copy

• snowflake.yml 파일에서 다음과 같이 정의합니다.

  test_function:
    type: "function"
    handler: "app.udf"
    identifier:
      name: "udf"
    stage: "dev_deployment"
    signature: ""
    returns: float
    artifact_repository: snowflake.snowpark.pypi_shared_repository
      - 'scikit-learn'
    artifacts:
      - "app.py"
  

  Copy

특정 아키텍처에 종속성이 있는 패키지의 경우 다음과 같이 resource_constraint 매개 변수에서 정의할 수 있습니다.

test_function:
  type: "function"
  handler: "app.udf"
  identifier:
    name: "udf"
  stage: "dev_deployment"
  signature: ""
  returns: float
  artifact_repository: snowflake.snowpark.pypi_shared_repository
    - 'scikit-learn'
  artifacts:
    - "app.py"
  resource_constraint:
    architecture: 'x86'

자세한 내용은 x86 전용으로 빌드된 패키지 섹션을 참조하십시오.

packages

선택 사항, 문자열

artifact_repository에서 설치할 패키지의 목록입니다. 예:

artifact_repository: snowflake.snowpark.pypi_shared_repository
packages:

  - Faker
  - rich
  - pytest

핸들러

필수, 문자열

snowpark.src 에 정의된 모듈 내부의 오브젝트에 대한 함수 또는 프로시저의 구현입니다. 예를 들어, functions.hello_function 은 <src>/functions.py 파일의 hello_function 함수를 참조합니다.

서명

필수, 시퀀스

signature 매개 변수는 오브젝트에 전달되는 연속된 인자를 설명합니다. 각각의 이름과 유형을 지정해야 합니다. 예:

signature:
  - name: "first_argument"
    type: int
  - name: "second_argument"
    default: "default value"
    type: string

함수나 프로시저에 인자를 받지 않는 경우 이 값을 빈 문자열(signature: "")로 설정합니다.

사용 가능한 유형 열의 SQL 유형 을 확인합니다. 명명된 인자와 선택적 인자의 구문에 대해 자세히 알아보려면 선택적 인자가 있는 UDF 호출하기 섹션을 참조하십시오.

external_access_integrations

선택 사항, 문자열 시퀀스

이 절차의 핸들러 코드가 외부 네트워크에 액세스하는 데 필요한 외부 액세스 통합 의 이름입니다. 자세한 내용은 CREATE PROCEDURE 의 EXTERNAL_ACCESS_INTEGRATIONS 매개 변수 를 참조하십시오.

가져오기

선택 사항, 문자열 시퀀스

가져올 이전에 업로드한 파일의 스테이지와 경로입니다. 자세한 내용은 CREATE PROCEDURE의 IMPORT 매개 변수 섹션을 참조하세요.