Add support for JSON Index creation syntax in SQL Server 2025 (TSql170)

.gitignore

@@ -356,4 +356,7 @@ MigrationBackup/
 out/
 
 # Project packages folder
-.packages/
+.packages/
+
+# Temporary build artifacts
+tmp/

SqlScriptDom/Parser/TSql/Ast.xml

@@ -4596,6 +4596,14 @@
     <Member Name="OnFileGroupOrPartitionScheme" Type="FileGroupOrPartitionScheme" Summary="The filegroup or partition scheme. Might be null."/>
     <Member Name="OrderedColumns" Type="ColumnReferenceExpression" Collection="true" Summary="The columns which ordered columnstore indexes should be ordered on." />
   </Class>
+  <Class Name="CreateJsonIndexStatement" Base="TSqlStatement" Summary="Represents the create JSON index statement.">
+    <Member Name="Name" Type="Identifier" Summary="The name of the index."/>
+    <Member Name="OnName" Type="SchemaObjectName" Summary="The table or view name that comes after the ON keyword."/>
+    <Member Name="JsonColumn" Type="ColumnReferenceExpression" Summary="The JSON column for the index."/>
+    <Member Name="JsonPaths" Type="StringLiteral" Collection="true" Summary="The JSON paths specified in the FOR clause. Optional may have zero elements."/>
+    <Member Name="IndexOptions" Type="IndexOption" Collection="true" Summary="The index options. Optional may have zero elements."/>
+    <Member Name="OnFileGroupOrPartitionScheme" Type="FileGroupOrPartitionScheme" Summary="The filegroup or partition scheme. Might be null."/>
+  </Class>
   <Class Name="WindowFrameClause" Summary="Represents the specification of window bounds for windowing aggregates.">
     <Member Name="Top" Type="WindowDelimiter" Summary="Top boundary of the window."/>
     <Member Name="Bottom" Type="WindowDelimiter" Summary="Bottom boundary of the window. Optional may be null."/>

SqlScriptDom/Parser/TSql/TSql170.g

@@ -883,6 +883,9 @@ create2005Statements returns [TSqlStatement vResult = null]
         |
             {NextTokenMatches(CodeGenerationSupporter.ColumnStore)}?
             vResult=createColumnStoreIndexStatement[null, null]
+        |
+            {NextTokenMatches(CodeGenerationSupporter.Json)}?
+            vResult=createJsonIndexStatement[null, null]
         |
             {NextTokenMatches(CodeGenerationSupporter.Contract)}?
             vResult=createContractStatement
@@ -16824,6 +16827,7 @@ createIndexStatement returns [TSqlStatement vResult = null]
                 (
                     vResult=createRelationalIndexStatement[tUnique, isClustered]
                     | vResult=createColumnStoreIndexStatement[tUnique, isClustered]
+                    | vResult=createJsonIndexStatement[tUnique, isClustered]
                 )
             )
         |
@@ -16960,6 +16964,65 @@ createColumnStoreIndexStatement [IToken tUnique, bool? isClustered] returns [Cre
         )?
     ;
 
+createJsonIndexStatement [IToken tUnique, bool? isClustered] returns [CreateJsonIndexStatement vResult = FragmentFactory.CreateFragment<CreateJsonIndexStatement>()]
+{
+    Identifier vIdentifier;
+    SchemaObjectName vSchemaObjectName;
+    ColumnReferenceExpression vJsonColumn;
+    FileGroupOrPartitionScheme vFileGroupOrPartitionScheme;
+    StringLiteral vPath;
+
+    if (tUnique != null)
+    {
+        ThrowIncorrectSyntaxErrorException(tUnique);
+    }
+    if (isClustered.HasValue)
+    {
+        ThrowIncorrectSyntaxErrorException(LT(1));
+    }
+}
+    : tJson:Identifier tIndex:Index vIdentifier=identifier
+    {
+        Match(tJson, CodeGenerationSupporter.Json);
+        vResult.Name = vIdentifier;
+    }
+    tOn:On vSchemaObjectName=schemaObjectThreePartName
+    {
+        vResult.OnName = vSchemaObjectName;
+    }
+    LeftParenthesis vJsonColumn=column tRParen:RightParenthesis
+    {
+        vResult.JsonColumn = vJsonColumn;
+        UpdateTokenInfo(vResult, tRParen);
+    }
+    (
+        tFor:For LeftParenthesis
+        vPath=stringLiteral
+        {
+            AddAndUpdateTokenInfo(vResult, vResult.JsonPaths, vPath);
+        }
+        (
+            Comma vPath=stringLiteral
+            {
+                AddAndUpdateTokenInfo(vResult, vResult.JsonPaths, vPath);
+            }
+        )*
+        RightParenthesis
+    )?
+    (
+        // Greedy due to conflict with withCommonTableExpressionsAndXmlNamespaces
+        options {greedy = true; } :
+        With
+        indexOptionList[IndexAffectingStatement.CreateIndex, vResult.IndexOptions, vResult]
+    )?
+    (
+        On vFileGroupOrPartitionScheme=filegroupOrPartitionScheme
+        {
+            vResult.OnFileGroupOrPartitionScheme = vFileGroupOrPartitionScheme;
+        }
+    )?
+    ;
+
 indexKeyColumnList[CreateIndexStatement vParent]
 {
     ColumnWithSortOrder vColumnWithSortOrder;

SqlScriptDom/ScriptDom/SqlServer/ScriptGenerator/SqlScriptGeneratorVisitor.CreateJsonIndexStatement.cs

@@ -0,0 +1,57 @@
+//------------------------------------------------------------------------------
+// <copyright file="SqlScriptGeneratorVisitor.CreateJsonIndexStatement.cs" company="Microsoft">
+//         Copyright (c) Microsoft Corporation.  All rights reserved.
+// </copyright>
+//------------------------------------------------------------------------------
+using System.Collections.Generic;
+using Microsoft.SqlServer.TransactSql.ScriptDom;
+
+namespace Microsoft.SqlServer.TransactSql.ScriptDom.ScriptGenerator
+{
+    partial class SqlScriptGeneratorVisitor
+    {
+        public override void ExplicitVisit(CreateJsonIndexStatement node)
+        {
+            GenerateKeyword(TSqlTokenType.Create);
+
+            GenerateSpaceAndIdentifier(CodeGenerationSupporter.Json);
+
+            GenerateSpaceAndKeyword(TSqlTokenType.Index);
+
+            // name
+            GenerateSpaceAndFragmentIfNotNull(node.Name);
+
+            NewLineAndIndent();
+            GenerateKeyword(TSqlTokenType.On);
+            GenerateSpaceAndFragmentIfNotNull(node.OnName);
+
+            // JSON column
+            if (node.JsonColumn != null)
+            {
+                GenerateSpace();
+                GenerateSymbol(TSqlTokenType.LeftParenthesis);
+                GenerateFragmentIfNotNull(node.JsonColumn);
+                GenerateSymbol(TSqlTokenType.RightParenthesis);
+            }
+
+            // FOR clause with JSON paths
+            if (node.JsonPaths != null && node.JsonPaths.Count > 0)
+            {
+                NewLineAndIndent();
+                GenerateKeyword(TSqlTokenType.For);
+                GenerateSpace();
+                GenerateParenthesisedCommaSeparatedList(node.JsonPaths);
+            }
+
+            GenerateIndexOptions(node.IndexOptions);
+
+            if (node.OnFileGroupOrPartitionScheme != null)
+            {
+                NewLineAndIndent();
+                GenerateKeyword(TSqlTokenType.On);
+
+                GenerateSpaceAndFragmentIfNotNull(node.OnFileGroupOrPartitionScheme);
+            }
+        }
+    }
+}

Test/SqlDom/Baselines170/JsonIndexTests170.sql

@@ -0,0 +1,38 @@
+CREATE JSON INDEX IX_JSON_Basic
+    ON dbo.Users (JsonData);
+
+CREATE JSON INDEX IX_JSON_SinglePath
+    ON dbo.Users (JsonData)
+    FOR ('$.name');
+
+CREATE JSON INDEX IX_JSON_MultiplePaths
+    ON dbo.Users (JsonData)
+    FOR ('$.name', '$.email', '$.age');
+
+CREATE JSON INDEX IX_JSON_WithOptions
+    ON dbo.Users (JsonData) WITH (FILLFACTOR = 90, ONLINE = OFF);
+
+CREATE JSON INDEX IX_JSON_Complete
+    ON dbo.Users (JsonData)
+    FOR ('$.profile.name', '$.profile.email') WITH (MAXDOP = 4, DATA_COMPRESSION = ROW);
+
+CREATE JSON INDEX IX_JSON_Filegroup
+    ON dbo.Users (JsonData)
+    ON [PRIMARY];
+
+CREATE JSON INDEX IX_JSON_Full
+    ON dbo.Users (JsonData)
+    FOR ('$.orders[*].amount', '$.orders[*].date') WITH (DROP_EXISTING = OFF, ALLOW_ROW_LOCKS = ON)
+    ON [JsonIndexes];
+
+CREATE JSON INDEX IX_JSON_Schema
+    ON MySchema.MyTable (JsonColumn)
+    FOR ('$.properties.value');
+
+CREATE JSON INDEX [IX JSON Index]
+    ON [dbo].[Users] ([Json Data])
+    FOR ('$.data.attributes');
+
+CREATE JSON INDEX IX_JSON_Complex
+    ON dbo.Documents (Content)
+    FOR ('$.metadata.title', '$.content.sections[*].text', '$.tags[*]');

Test/SqlDom/Only170SyntaxTests.cs

@@ -9,7 +9,8 @@ public partial class SqlDomTests
         // Note: These filenames are case sensitive, make sure they match the checked-in file exactly
         private static readonly ParserTest[] Only170TestInfos =
         {
-            new ParserTest170("RegexpTVFTests170.sql", nErrors80: 1, nErrors90: 1, nErrors100: 0, nErrors110: 0, nErrors120: 0, nErrors130: 0, nErrors140: 0, nErrors150: 0, nErrors160: 0)
+            new ParserTest170("RegexpTVFTests170.sql", nErrors80: 1, nErrors90: 1, nErrors100: 0, nErrors110: 0, nErrors120: 0, nErrors130: 0, nErrors140: 0, nErrors150: 0, nErrors160: 0),
+            new ParserTest170("JsonIndexTests170.sql", nErrors80: 2, nErrors90: 10, nErrors100: 10, nErrors110: 10, nErrors120: 10, nErrors130: 10, nErrors140: 10, nErrors150: 10, nErrors160: 10)
         };
 
         private static readonly ParserTest[] SqlAzure170_TestInfos =

Test/SqlDom/TestScripts/JsonIndexTests170.sql

@@ -0,0 +1,41 @@
+-- Basic JSON index creation
+CREATE JSON INDEX IX_JSON_Basic ON dbo.Users (JsonData);
+
+-- JSON index with FOR clause (single path)
+CREATE JSON INDEX IX_JSON_SinglePath ON dbo.Users (JsonData)
+FOR ('$.name');
+
+-- JSON index with FOR clause (multiple paths)
+CREATE JSON INDEX IX_JSON_MultiplePaths ON dbo.Users (JsonData)
+FOR ('$.name', '$.email', '$.age');
+
+-- JSON index with WITH options
+CREATE JSON INDEX IX_JSON_WithOptions ON dbo.Users (JsonData)
+WITH (FILLFACTOR = 90, ONLINE = OFF);
+
+-- JSON index with FOR clause and WITH options
+CREATE JSON INDEX IX_JSON_Complete ON dbo.Users (JsonData)
+FOR ('$.profile.name', '$.profile.email')
+WITH (MAXDOP = 4, DATA_COMPRESSION = ROW);
+
+-- JSON index with ON filegroup
+CREATE JSON INDEX IX_JSON_Filegroup ON dbo.Users (JsonData)
+ON [PRIMARY];
+
+-- JSON index with FOR clause, WITH options, and ON filegroup
+CREATE JSON INDEX IX_JSON_Full ON dbo.Users (JsonData)
+FOR ('$.orders[*].amount', '$.orders[*].date')
+WITH (DROP_EXISTING = OFF, ALLOW_ROW_LOCKS = ON)
+ON [JsonIndexes];
+
+-- JSON index on schema-qualified table
+CREATE JSON INDEX IX_JSON_Schema ON MySchema.MyTable (JsonColumn)
+FOR ('$.properties.value');
+
+-- JSON index with quoted identifiers
+CREATE JSON INDEX [IX JSON Index] ON [dbo].[Users] ([Json Data])
+FOR ('$.data.attributes');
+
+-- JSON index with complex path expressions
+CREATE JSON INDEX IX_JSON_Complex ON dbo.Documents (Content)
+FOR ('$.metadata.title', '$.content.sections[*].text', '$.tags[*]');

global.json

@@ -1,6 +1,6 @@
 {
     "sdk": {
-      "version": "8.0.410",
+      "version": "8.0.117",
       "rollForward": "latestMajor"
     },
     "msbuild-sdks": {