SHOW FILE FORMATS¶
액세스 권한이 있는 파일 형식을 나열합니다. 이 명령을 사용해 지정된 데이터베이스 또는 스키마(또는 세션의 현재 데이터베이스/스키마) 또는 전체 계정에 대한 파일 형식을 나열할 수 있습니다.
구문
SHOW FILE FORMATS [ LIKE '<pattern>' ]
[ IN
{
ACCOUNT |
DATABASE |
DATABASE <database_name> |
SCHEMA |
SCHEMA <schema_name> |
<schema_name>
}
]
매개 변수¶
LIKE 'pattern'오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(
%및_) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.예를 들어, 다음 패턴은 같은 결과를 반환합니다.
... LIKE '%testing%' ...... LIKE '%TESTING%' .... 기본값: 값 없음(출력에 필터링이 적용되지 않음).
[ IN ... ]선택적으로 명령의 범위를 지정합니다. 다음 중 하나를 지정합니다.
ACCOUNT전체 계정의 레코드를 반환합니다.
DATABASE, .DATABASE db_name현재 사용 중인 데이터베이스 또는 지정된 데이터베이스(
db_name)의 레코드를 반환합니다.db_name없이DATABASE를 지정하고 사용 중인 데이터베이스가 없는 경우 키워드는 출력에 아무런 영향도 주지 않습니다.SCHEMA, .SCHEMA schema_name, .schema_name현재 사용 중인 스키마 또는 지정된 스키마(
schema_name)의 레코드를 반환합니다.데이터베이스가 사용 중이거나 정규화된
schema_name(예:db.schema)을 지정하는 경우SCHEMA는 선택 사항입니다.사용 중인 데이터베이스가 없으면
SCHEMA를 지정해도 출력에 아무런 영향도 주지 않습니다.
기본값: 세션에 현재 사용 중인 데이터베이스가 있는지 여부에 따라 다릅니다.
데이터베이스:
DATABASE가 기본값입니다(즉, 이 명령은 데이터베이스에서 볼 권한이 있는 오브젝트를 반환함).데이터베이스 없음:
ACCOUNT가 기본값입니다(즉, 이 명령은 계정에서 볼 권한이 있는 오브젝트를 반환함).
사용법 노트¶
접두사
is_로 시작하는 열은Y(예) 또는N(아니요)을 반환합니다.이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.
이 명령은 명령을 실행하는 데 사용되는 역할에 대한 액세스 권한에 따라 지정된 오브젝트 유형에 대해 최대 10,000개의 레코드를 반환합니다. 필터가 적용된 경우에도 10,000개의 제한을 초과하는 레코드는 반환되지 않습니다.
10,000개 이상의 레코드가 존재하는 결과를 보려면 Snowflake Information Schema 에서 해당 뷰(있는 경우)를 쿼리하십시오.
이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.
이 명령의 출력은
SN_TEMP_OBJECT_<n>(여기서<n>은 숫자임)과 같은 이름을 가진 오브젝트를 포함할 수 있습니다. 이들 오브젝트는 사용자를 대신하여 Snowpark 라이브러리에서 생성되는 임시 오브젝트입니다.
출력¶
명령 출력은 다음 열에 파일 형식 속성 및 메타데이터를 제공합니다.
열 |
설명 |
|---|---|
format_options |
파일 형식 유형에 대한 모든 옵션의 값입니다. 명시적으로 정의되지 않은 옵션의 기본값을 반환합니다. |
created_on |
데이터베이스가 만들어진 날짜 및 시간입니다. |
이름 |
파일 형식의 이름입니다. |
데이터베이스_이름 |
파일 형식이 저장된 데이터베이스입니다. |
스키마_이름 |
파일 형식이 저장된 스키마입니다. |
타입 |
파일 형식 유형: CSV, JSON, Avro, ORC, Parquet 또는 XML. |
owner |
파일 형식을 소유하는 역할입니다. |
comment |
데이터베이스에 대한 설명입니다. |
owner_role_type |
오브젝트를 소유하는 역할 유형( |
예¶
다음 예는 모두 똑같습니다.
USE DATABASE testdb; SHOW FILE FORMATS;+---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+ | created_on | name | database_name | schema_name | type | owner | comment | owner_role_type | +---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+ | Wed, 29 Apr 2015 18:59:03 -0700 | MY_FORMAT | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | CSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | VSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | TSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | +---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+SHOW FILE FORMATS IN DATABASE testdb;+---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+ | created_on | name | database_name | schema_name | type | owner | comment | owner_role_type | +---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+ | Wed, 29 Apr 2015 18:59:03 -0700 | MY_FORMAT | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | CSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | VSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | TSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | +---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+SHOW FILE FORMATS IN SCHEMA testdb.public;+---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+ | created_on | name | database_name | schema_name | type | owner | comment | owner_role_type | +---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+ | Wed, 29 Apr 2015 18:59:03 -0700 | MY_FORMAT | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | CSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | VSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | | Mon, 27 Apr 2015 17:49:12 -0700 | TSV | TESTDB | PUBLIC | CSV | ACCOUNTADMIN | | ROLE | +---------------------------------+-----------+---------------+-------------+------+--------------+---------+-----------------+