snow object create¶

구문¶

snow object create
  <object_type>
  <object_attributes>
  --json <object_json>
  --connection <connection>
  --host <host>
  --port <port>
  --account <account>
  --user <user>
  --password <password>
  --authenticator <authenticator>
  --private-key-file <private_key_file>
  --token-file-path <token_file_path>
  --database <database>
  --schema <schema>
  --role <role>
  --warehouse <warehouse>
  --temporary-connection
  --mfa-passcode <mfa_passcode>
  --enable-diag
  --diag-log-path <diag_log_path>
  --diag-allowlist-path <diag_allowlist_path>
  --format <format>
  --verbose
  --debug
  --silent

인자¶

object_type

오브젝트 유형입니다. 예를 들어, 테이블, 데이터베이스, 컴퓨팅 풀 등이 있습니다.

object_attributes...

키=값 페어의 목록으로 제공되는 오브젝트 특성(예: name=my_db comment=’created with Snowflake CLI’)입니다. 모든 오브젝트에 대해 사용 가능한 매개 변수의 전체 목록은 설명서를 확인하십시오.

선택 사항¶

--json TEXT

JSON 형식의 오브젝트 정의로, 예를 들어 ‘{“name”: “my_db”, “comment”: “created with Snowflake CLI”}’입니다. 각 오브젝트에 대해 사용 가능한 매개 변수의 전체 목록은 설명서를 확인하십시오.

--connection, -c, --environment TEXT

config.toml 파일에 정의된 연결의 이름입니다. 기본값: default.

--host TEXT

연결을 위한 호스트 주소입니다. 연결에 지정된 값을 재정의합니다.

--port INTEGER

연결의 포트입니다. 연결에 지정된 값을 재정의합니다.

--account, --accountname TEXT

Snowflake 계정에 할당된 이름입니다. 연결에 지정된 값을 재정의합니다.

--user, --username TEXT

Snowflake에 연결할 사용자 이름입니다. 연결에 지정된 값을 재정의합니다.

--password TEXT

Snowflake 비밀번호입니다. 연결에 지정된 값을 재정의합니다.

--authenticator TEXT

Snowflake 인증자입니다. 연결에 지정된 값을 재정의합니다.

--private-key-file, --private-key-path TEXT

Snowflake 개인 키 파일 경로입니다. 연결에 지정된 값을 재정의합니다.

--token-file-path TEXT

Snowflake에 연결할 때 사용해야 하는 OAuth 토큰이 포함된 파일 경로입니다.

--database, --dbname TEXT

사용할 데이터베이스입니다. 연결에 지정된 값을 재정의합니다.

--schema, --schemaname TEXT

사용할 데이터베이스 스키마입니다. 연결에 지정된 값을 재정의합니다.

--role, --rolename TEXT

사용할 역할입니다. 연결에 지정된 값을 재정의합니다.

--warehouse TEXT

사용할 웨어하우스입니다. 연결에 지정된 값을 재정의합니다.

--temporary-connection, -x

config에서 정의된 연결 대신, 명령줄 매개 변수로 정의된 연결을 사용합니다. 기본값: False.

--mfa-passcode TEXT

다단계 인증(MFA)에 사용할 토큰입니다.

--enable-diag

Python 커넥터 진단 테스트를 실행합니다. 기본값: False.

--diag-log-path TEXT

진단 보고서 경로입니다. 기본값: <temporary_directory>.

--diag-allowlist-path TEXT

선택적 허용 목록에 대한 진단 보고서 경로입니다.

--format [TABLE|JSON]

출력 형식을 지정합니다. 기본값: TABLE.

--verbose, -v

로그 수준 info 이상의 로그 항목을 표시합니다. 기본값: False.

--debug

로그 수준 디버그 이상에 대한 로그 항목을 표시하며, 디버그 로그에는 추가 정보가 포함됩니다. 기본값: False.

--silent

콘솔로의 중간 출력을 끕니다. 기본값: False.

--help

이 명령에 대한 도움말 텍스트를 표시합니다.

사용법 노트¶

snow object create 명령은 제공된 오브젝트 특성 또는 정의에 따라 다음 유형 중 하나에 해당하는 Snowflake 오브젝트를 생성합니다.

• account

• catalog-integration

• compute-pool

• database

• database-role

• dynamic-table

• event-table

• external-volume

• function

• image-repository

• managed-account

• network-policy

• notebook

• notification-integration

• pipe

• procedure

• role

• schema

• service

• stage

• stream

• table

• task

• user-defined-function

• view

• warehouse

각 오브젝트에 대해 오브젝트 특성이나 오브젝트 정의를 사용하여 적절한 오브젝트 세부 정보를 지정해야 합니다.

• object_attributes 매개 변수를 사용하여 다음과 같이 오브젝트 세부 정보를 일련의 <key>=<value> 페어로 지정합니다.

  snow object create database name=my_db comment="Created with Snowflake CLI"
  

  Copy

• 다음과 같이 오브젝트 세부 정보를 JSON으로 지정하려면 --json object_definition 옵션을 사용합니다.

  snow object create table name=my_table columns='[{"name":"col1","datatype":"number", "nullable":false}]' constraints='[{"name":"prim_key", "column_names":["col1"], "constraint_type":"PRIMARY KEY"}]' --database my_db
  

  Copy

• 추가적인 예제는 예제 섹션을 참조하십시오.

다음 섹션에서는 선택한 오브젝트 유형에 대해 Snowflake CLI 가 지원하는 특성에 대해 설명합니다.

• compute-pool

• database

• image-repository

• schema

• service

• table

• task

• warehouse

다른 유형의 오브젝트에 대한 특성은 해당 SQL CREATE 명령 참조(예: CREATE ACCOUNT)를 확인하여 찾을 수 있습니다.

예¶

• option-attributes 매개 변수를 사용하여 데이터베이스 오브젝트를 생성합니다.

  snow object create database name=my_db comment='Created with Snowflake CLI'
  

  Copy

• option-attributes 매개 변수를 사용하여 테이블 오브젝트를 생성합니다.

  snow object create table name=my_table columns='[{"name":"col1","datatype":"number", "nullable":false}]' constraints='[{"name":"prim_key", "column_names":["col1"], "constraint_type":"PRIMARY KEY"}]' --database my_db
  

  Copy

• --json object-definition 옵션을 사용하여 데이터베이스를 생성합니다.

  snow object create database --json '{"name":"my_db", "comment":"Created with Snowflake CLI"}'
  

  Copy

• --json object-definition 옵션을 사용하여 테이블을 생성합니다.

  snow object create table --json "$(cat table.json)" --database my_db
  

  Copy

  여기서 table.json 에는 다음이 포함됩니다.

  {
    "name": "my_table",
    "columns": [
      {
        "name": "col1",
        "datatype": "number",
        "nullable": false
      }
    ],
    "constraints": [
      {
        "name": "prim_key",
        "column_names": ["col1"],
        "constraint_type": "PRIMARY KEY"
      }
    ]
  }
  

  Copy