ISJSON (Transact-SQL)ISJSON (Transact-SQL)

Применимо к:Applies to: даSQL Server 2016 (13.x);SQL Server 2016 (13.x)yesSQL Server 2016 (13.x);SQL Server 2016 (13.x) и более поздние версии ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse AnalyticsПрименимо к:Applies to: даSQL Server 2016 (13.x);SQL Server 2016 (13.x)yesSQL Server 2016 (13.x);SQL Server 2016 (13.x) and later ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics

Проверяет, что строка содержит допустимые данные JSON.Tests whether a string contains valid JSON.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

ISJSON ( expression )  

АргументыArguments

expressionexpression
Строка для проверки.The string to test.

Возвращаемое значениеReturn Value

Возвращает 1, если строка содержит допустимые данные JSON; в противном случае возвращает 0.Returns 1 if the string contains valid JSON; otherwise, returns 0. Возвращает значение NULL, если выражение имеет значение NULL.Returns null if expression is null.

Не возвращает ошибок.Does not return errors.

ПримечанияRemarks

ISJSON не проверяет уникальность ключей на том же уровне.ISJSON does not check the uniqueness of keys at the same level.

ПримерыExamples

Пример 1Example 1

В следующем примере выполняется условный блок операторов, если значение параметра @param содержит допустимый код JSON.The following example runs a statement block conditionally if the parameter value @param contains valid JSON.

DECLARE @param <data type>
SET @param = <value>

IF (ISJSON(@param) > 0)  
BEGIN  
     -- Do something with the valid JSON value of @param.  
END

Пример 2Example 2

В следующем примере возвращаются строки, в которых столбец json_col содержит допустимые данные JSON.The following example returns rows in which the column json_col contains valid JSON.

SELECT id, json_col
FROM tab1
WHERE ISJSON(json_col) > 0 

См. такжеSee Also

Данные JSON (SQL Server)JSON Data (SQL Server)