Categorias:: Funções do sistema (Informações do sistema)

SYSTEM$CLIENT_VERSION_INFO¶

Retorna informações de versão para clientes e drivers Snowflake.

Consulte também:: Versões de cliente e política de suporte

Sintaxe¶

SYSTEM$CLIENT_VERSION_INFO()

Copy

Argumentos¶

Nenhum

Retornos¶

Retorna uma cadeia de caracteres contendo uma matriz JSON de objetos. Cada objeto contém informações sobre um cliente e driver específico, como SnowSQL, o driver JDBC e assim por diante.

Cada objeto JSON contém os seguintes pares nome/valor:

{
  "clientId": "DOTNETDriver",
  "minimumSupportedVersion": "2.0.4",
  "minimumNearingEndOfSupportVersion": "2.0.7",
  "recommendedVersion": "2.1.2",
  "deprecatedVersions": [],
  "_customSupportedVersions_": []
}

Copy

Onde:

clientId
Nome do cliente ou driver. Os valores possíveis incluem:

DOTNETDriver

GO

JDBC

JSDriver

ODBC

PHP

PythonConnector

SnowSQL

SQLAPI

minimumSupportedVersion
Versão mais antiga do cliente ou driver oficialmente suportada.

minimumNearingEndOfSupportVersion
Versão do cliente ou driver que atinge o fim do suporte (EOS) no início do próximo trimestre.

recommendedVersion
Versão atual do cliente ou driver.

deprecatedVersions, _customSupportedVersions_
Somente para uso interno.

Notas de uso¶

Se preferir não processar JSON, você pode usar as funções PARSE_JSON e LATERAL FLATTEN para converter JSON em saída colunar.
Você também pode usar a cláusula WHERE para retornar as informações de um cliente ou driver específico (clientId).

Exemplos¶

O exemplo a seguir recupera as informações de versão de todos os clientes e drivers Snowflake:

SELECT SYSTEM$CLIENT_VERSION_INFO();

Copy

[
  {
    "clientId": "DOTNETDriver",
    "minimumSupportedVersion": "2.0.4",
    "minimumNearingEndOfSupportVersion": "2.0.7",
    "recommendedVersion": "2.1.2",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "GO",
    "minimumSupportedVersion": "1.6.0",
    "minimumNearingEndOfSupportVersion": "1.6.3",
    "recommendedVersion": "1.6.25",
    "deprecatedVersions": [],
    "_customSupportedVersions_": ["1.1.5"]
  },
  {
    "clientId": "JDBC",
    "minimumSupportedVersion": "3.13.6",
    "minimumNearingEndOfSupportVersion": "3.13.10",
    "recommendedVersion": "3.14.3",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "JSDriver",
    "minimumSupportedVersion": "1.6.2",
    "minimumNearingEndOfSupportVersion": "1.6.4",
    "recommendedVersion": "1.9.0",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "ODBC",
    "minimumSupportedVersion": "2.23.3",
    "minimumNearingEndOfSupportVersion": "2.24.2",
    "recommendedVersion": "3.1.1",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "PHP",
    "minimumSupportedVersion": "1.1.0",
    "minimumNearingEndOfSupportVersion": "1.2.0",
    "recommendedVersion": "2.1.0",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "PythonConnector",
    "minimumSupportedVersion": "2.5.0",
    "minimumNearingEndOfSupportVersion": "2.7.0",
    "recommendedVersion": "3.4.1",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "SnowSQL",
    "minimumSupportedVersion": "1.2.17",
    "minimumNearingEndOfSupportVersion": "1.2.20",
    "recommendedVersion": "1.2.29",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  },
  {
    "clientId": "SQLAPI",
    "minimumSupportedVersion": "1.0.0",
    "minimumNearingEndOfSupportVersion": "",
    "recommendedVersion": "",
    "deprecatedVersions": [],
    "_customSupportedVersions_": []
  }
]

O exemplo a seguir retorna as informações de versão de todos os clientes como um conjunto de linhas:

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');

Copy

+-----------------+-----------------+-----------------------------+---------------------+
| CLIENT_ID       | MINIMUM_VERSION | NEAR_END_OF_SUPPORT_VERSION | RECOMMENDED_VERSION |
|-----------------+-----------------+-----------------------------+---------------------|
| DOTNETDriver    | 2.0.4           | 2.0.7                       | 2.1.2               |
| GO              | 1.6.0           | 1.6.3                       | 1.6.25              |
| JDBC            | 3.13.6          | 3.13.10                     | 3.14.3              |
| JSDriver        | 1.6.2           | 1.6.4                       | 1.9.0               |
| ODBC            | 2.23.3          | 2.24.2                      | 3.1.1               |
| PHP             | 1.1.0           | 1.2.0                       | 2.1.0               |
| PythonConnector | 2.5.0           | 2.7.0                       | 3.4.1               |
| SnowSQL         | 1.2.17          | 1.2.20                      | 1.2.29              |
| SQLAPI          | 1.0.0           |                             |                     |
+-----------------+-----------------+-----------------------------+---------------------+

O exemplo a seguir retorna as informações de versão do driver JDBC como um conjunto de linhas:

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';

Copy

+-----------+-----------------+-----------------------------+---------------------+
| CLIENT_ID | MINIMUM_VERSION | NEAR_END_OF_SUPPORT_VERSION | RECOMMENDED_VERSION |
|-----------+-----------------+-----------------------------+---------------------|
| JDBC      | 3.13.6          | 3.13.10                     | 3.14.3              |
+-----------+-----------------+-----------------------------+---------------------+