SYSTEM$CLIENT_VERSION_INFO

SYSTEM$CLIENT_VERSION_INFO 함수는 Snowflake 클라이언트 및 드라이버에 대한 버전 정보를 반환해요.

출처: SYSTEM$CLIENT_VERSION_INFO

본문

SYSTEM$CLIENT_VERSION_INFO 함수는 Snowflake 클라이언트 및 드라이버에 대한 버전 정보를 반환해요.

함께 보기: 클라이언트 버전 및 지원 정책 (Client versions & support policy)

구문 (Syntax)

SYSTEM$CLIENT_VERSION_INFO()

인자 (Arguments)

없음 (None).

반환 (Returns)

객체 배열을 포함하는 JSON 문자열을 반환해요. 각 객체는 특정 클라이언트 및 드라이버(예: SnowSQL, JDBC 드라이버 등)에 대한 정보를 포함해요.

각 JSON 객체는 다음 이름/값 쌍을 포함해요:

{
  "clientId": "DOTNETDriver",
  "clientAppId": ".NET",
  "minimumSupportedVersion": "2.0.9",
  "minimumNearingEndOfSupportVersion": "2.0.11",
  "recommendedVersion": "2.1.5",
  "deprecatedVersions": [],
  "_customSupportedVersions_": []
}

여기서:

clientId — 클라이언트 또는 드라이버의 내부 ID. 가능한 값: DOTNETDriver, GO, JDBC, JSDriver, ODBC, PHP_PDO, PythonConnector, SnowSQL, SQLAPI.
clientAppId — 클라이언트 또는 드라이버의 이름. 가능한 값: .NET, GO, JDBC, JavaScript, ODBC, PDO, PythonConnector, SnowSQL, SQLAPI.
minimumSupportedVersion — 공식적으로 지원되는 클라이언트 또는 드라이버의 가장 오래된 버전.
minimumNearingEndOfSupportVersion — 다음 분기 시작 시 지원 종료(EOS)에 도달하는 클라이언트 또는 드라이버의 버전.
recommendedVersion — 클라이언트 또는 드라이버의 현재 버전.
deprecatedVersions, customSupportedVersions — 내부 전용.

사용 메모 (Usage notes)

JSON을 처리하고 싶지 않으면 PARSE_JSON 및 LATERAL FLATTEN 함수를 사용해 JSON을 열 기반 출력으로 변환할 수 있어요.
WHERE 절을 사용해 특정 클라이언트 또는 드라이버(clientId)에 대한 정보를 반환할 수도 있어요.

예제 (Examples)

다음 예제는 모든 Snowflake 클라이언트 및 드라이버의 버전 정보를 검색해요. 출력은 가독성을 위해 수동으로 포맷되었어요:

SELECT SYSTEM$CLIENT_VERSION_INFO();

모든 클라이언트의 버전 정보를 행 집합으로 반환해요:

WITH output AS (
  SELECT
    PARSE_JSON(SYSTEM$CLIENT_VERSION_INFO()) a
)
SELECT
    value:clientAppId::STRING AS client_app_id,
    value:minimumSupportedVersion::STRING AS minimum_version,
    value:minimumNearingEndOfSupportVersion::STRING AS near_end_of_support_version,
    value:recommendedVersion::STRING AS recommended_version
  FROM output r,
    LATERAL FLATTEN(INPUT => r.a, MODE =>'array');

+-----------------+-----------------+-----------------------------+---------------------+
| CLIENT_APP_ID   | MINIMUM_VERSION | NEAR_END_OF_SUPPORT_VERSION | RECOMMENDED_VERSION |
|-----------------+-----------------+-----------------------------+---------------------|
| .NET            | 2.0.9           | 2.0.11                      | 2.1.5               |
| Go              | 1.6.6           | 1.6.9                       | 1.7.1               |
| JDBC            | 3.13.14         | 3.13.18                     | 3.14.4              |
| JavaScript      | 1.6.6           | 1.6.9                       | 1.9.2               |
| ODBC            | 2.23.5          | 2.24.7                      | 3.1.4               |
| PDO             | 1.2.0           | 1.2.1                       | 2.0.1               |
| PythonConnector | 2.7.3           | 2.7.7                       | 3.6.0               |
| SnowSQL         | 1.2.21          | 1.2.21                      | 1.2.31              |
| SQLAPI          | 1.0.0           |                             |                     |
+-----------------+-----------------+-----------------------------+---------------------+

JDBC 드라이버의 버전 정보를 행 집합으로 반환해요:

WITH output AS (
  SELECT
    PARSE_JSON(SYSTEM$CLIENT_VERSION_INFO()) a
)
SELECT
    value:clientId::STRING AS client_id,
    value:minimumSupportedVersion::STRING AS minimum_version,
    value:minimumNearingEndOfSupportVersion::STRING AS near_end_of_support_version,
    value:recommendedVersion::STRING AS recommended_version
  FROM output r,
    LATERAL FLATTEN(INPUT => r.a, MODE =>'array')
  WHERE client_id = 'JDBC';

+-----------+-----------------+-----------------------------+---------------------+
| CLIENT_ID | MINIMUM_VERSION | NEAR_END_OF_SUPPORT_VERSION | RECOMMENDED_VERSION |
|-----------+-----------------+-----------------------------+---------------------|
| JDBC      | 3.13.14         | 3.13.18                     | 3.14.4              |
+-----------+-----------------+-----------------------------+---------------------+

더 알아보기 (Learn more)

시스템 함수 (System functions)
시스템 정보 함수 (System Information)
클라이언트 버전 및 지원 정책 (Client versions & support policy)