설정 스크립트 만들기¶

설정 스크립트 정보¶

설정 스크립트에는 다음 컨텍스트 중 하나에서 CREATE APPLICATION 명령이 실행될 때 실행되는 SQL 문이 포함됩니다.

• 컨슈머가 Snowflake Native App 을 설치하거나 업그레이드합니다.

• A provider creates or upgrades an app when testing the application package.

The SQL statements in the setup script create objects within the app that are required by the app. This includes database objects, stored procedures, views, and application roles.

매니페스트 파일은 설정 스크립트에 대한 파일 이름과 상대 경로를 지정합니다. 설정 스크립트는 명명된 스테이징에 있어야 하며 앱 패키지에서 액세스할 수 있어야 합니다.

설정 스크립트에 대한 제한 사항¶

다음은 설정 스크립트 내에서 수행할 수 없습니다.

• USE DATABASE

• USE SCHEMA

• USE ROLE

• USE SECONDARY ROLES

• ALTER <오브젝트> 명령을 사용하여 LOG_LEVEL, TRACE_LEVEL 또는 METRIC_LEVEL 속성 설정.

• EXECUTE AS CALLER 프로시저 생성 또는 호출.

• 명명된 스테이지에 파일을 포함하기 위해 IMPORT를 사용하는 Snowpark 사용자 정의 함수(UDF) 또는 프로시저 생성.

• 애플리케이션 패키지에 포함되지 않은 코드를 참조하는 프로시저, 함수 또는 익명 코드 블록 호출.

• CREATE FUNCTION 명령 사용 시 명명된 스테이지에서 코드 파일 가져오기.

• CALL 을 사용하여 EXECUTE AS CALLER로 실행되는 프로시저 호출.

버전이 지정된 스키마 내에서 생성된 오브젝트에 대한 추가 제한 사항이 있습니다.

설정 스크립트에서 생성된 오브젝트의 표시 유형¶

The setup script can create most types of database-level objects. Database objects created by the setup script are internal to the app. When a consumer installs an app, by default, these objects are invisible and inaccessible to the consumer account directly.

A provider can make these objects visible to the consumer using application roles. An application role created within the setup script is automatically granted to the role owning the app. Application roles granted by the setup script cannot be revoked.

Users that have been granted a role that owns the application object can grant application roles to other roles within their account. For example, the setup script can define an application role, such as APP_ADMIN, and this role can grant permission to access objects within the app.

설정 스크립트에 의해 출력되는 메시지의 로그 수준을 설정합니다.¶

공급자는 설정 스크립트가 실행될 때 생성되는 메시지의 로그 수준을 지정할 수 있습니다. 추가 정보는 Snowflake Scripting에서 메시지 로깅하기 섹션을 참조하십시오.

설정 스크립트의 로그 수준을 구성하려면 다음 시스템 함수 중 하나를 사용하십시오.

• SYSTEM$LOG

• SYSTEM$LOG_<level>

예를 들어, 오류 메시지를 기록하도록 설정 스크립트를 구성하려면 설정 스크립트 시작 부분에 다음 명령을 추가하십시오.

SYSTEM$LOG('error', 'Error message');

모듈식 설정 스크립트 만들기¶

일반적인 앱의 설정 스크립트는 규모가 크고 복잡할 수 있습니다. 설정 스크립트를 보다 모듈화하고 유지 관리하기 더 쉽게 만들기 위해 공급자는 여러 보조 설정 스크립트를 호출하는 기본 설정 스크립트를 만들 수 있습니다.

예를 들어, 공급자는 오브젝트 생성, 뷰 생성, 저장 프로시저 생성 등 다양한 유형의 작업을 처리하기 위해 다양한 설정 스크립트를 생성할 수 있습니다.

CREATE APPLICATION 명령이 실행되면 매니페스트 파일에 지정된 기본 설정 스크립트가 실행됩니다. 기본 설정 스크립트에서 추가 설정 스크립트를 실행하려면 EXECUTE IMMEDIATE FROM 명령을 사용합니다.

기본 설정 스크립트에 포함된 설정 스크립트는 나타나는 순서대로 실행됩니다. 이러한 보조 설정 스크립트에는 EXECUTE IMMEDIATE FROM 명령의 인스턴스도 포함될 수 있습니다.

설정 스크립트 생성 시 모범 사례¶

Snowflake에서는 앱에 대한 설정 스크립트를 생성할 때 다음 모범 사례를 권장합니다.

CREATE SCHEMA IF NOT EXISTS app_config;
CREATE TABLE IF NOT EXISTS app_config.params(...);

CREATE OR REPLACE PROCEDURE app_state.proc()...;
GRANT USAGE ON PROCEDURE app_state.proc()
  TO APPLICATION ROLE app_user;

A TAG in a versioned schema can only be assigned to the objects in the same schema. An object in a versioned schema can only have a TAG assigned that is defined in the same schema.

애플리케이션 역할 정보¶

By default the consumer has no privileges on objects created within the app. Even the ACCOUNTADMIN role cannot view the objects within an app. Objects that the app creates outside itself, such as a database, are visible only to the ACCOUNTADMIN role of the consumer account.

Application roles are similar to database roles, but may only be created within the app. Unlike database roles, application roles can be granted privileges on objects that exist outside of the app.

Application roles should be created by the setup script when the app is installed and are automatically granted to the app owner’s role, who then can grant appropriate application roles to other roles in the consumer account.

Any privileges granted to application roles is passed to the app owner, which is the role used to install the app. The owner may further delegate application roles to other roles within the consumer account.

The setup script can also define an application role (e.g. USER). Using this role, consumers are granted access to use the functionality provided by the app. The setup script can define an application role, such as READ_ONLY, to provide restricted access to select areas of data within the app.

Unlike database roles, application roles may also be granted privileges on objects outside of the installed app. They may therefore be used to grant privileges on objects outside of the app. However, the application role itself must be created within the app.

애플리케이션 역할로 작업하기 위해 지원되는 SQL 명령¶

Snowflake Native App Framework 는 애플리케이션 역할로 작업하기 위해 다음 SQL 명령을 제공합니다.

• ALTER APPLICATION ROLE

• CREATE APPLICATION ROLE

• DROP APPLICATION ROLE

• GRANT APPLICATION ROLE

• REVOKE APPLICATION ROLE

• SHOW APPLICATION ROLES

설정 스크립트에서 애플리케이션 역할 사용하기¶

Application roles defined in the setup script are automatically granted to the role owning the app instance. When the app is installed, the role used to install the app is the owner of the app. However, the app owner can grant privileges to other account roles in the consumer account.

Application roles allow privileges on objects within the app to be granted to the consumer. For example:

CREATE APPLICATION ROLE admin;
CREATE APPLICATION ROLE user;
GRANT APPLICATION ROLE user TO APPLICATION ROLE admin;

CREATE OR ALTER VERSIONED SCHEMA app_code;
GRANT USAGE ON SCHEMA app_code TO APPLICATION ROLE admin;
GRANT USAGE ON SCHEMA app_code TO APPLICATION ROLE user;
CREATE OR REPLACE PROCEDURE app_code.config_app(...)
GRANT USAGE ON PROCEDURE app_code.config_app(..)
  TO APPLICATION ROLE admin;

CREATE OR REPLACE FUNCTION app_code.add(x INT, y INT)
GRANT USAGE ON FUNCTION app_code.add(INT, INT)
  TO APPLICATION ROLE admin;
GRANT USAGE ON FUNCTION app_code.add(INT, INT)
  TO APPLICATION ROLE user;

In this example, the setup script creates application roles named admin and a user. The setup script then grants both application roles access to the schema containing the app code. It also grants access to the add function within the schema. The admin role is also granted access to the config_app procedure.

애플리케이션 역할 및 버전¶

Application roles are not versioned. This means that dropping an application role or revoking a permission from an object that is not in a versioned schema can impact the current version of an application or the version being upgraded. Application roles may only be safely dropped when you have dropped all versions of the app that use those roles.