Improve documentation for resumable index limitations

[ClaudioESSilva]

I'm seeing a limitation when trying to use RESUMABLE and I have a computed column in the INCLUDED columns definition.

It errors as not supported.

Msg 10675, Level 16, State 1, Line 3
Internal Query Processor Error: The query processor could not produce a query plan. The RESUMABLE option is not supported for this index build. Remove the RESUMABLE option and rerun the statement.

If I remove that column from the INCLUDED columns, it works fine.

[prmerger-automator]

@ClaudioESSilva : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

[learn-build-service-prod]

Learn Build status updates of commit 3865518:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/t-sql/statements/create-index-transact-sql.md	✅Succeeded

For more details, please refer to the build report.

[ClaudioESSilva]

Steps to reproduce

DROP TABLE IF EXISTS dbo.OrdersWithComputedIncluded
CREATE TABLE dbo.OrdersWithComputedIncluded
(
    OrderID INT IDENTITY(1,1) NOT NULL,
    OrderDate DATETIME NOT NULL,
    CustomerID INT NOT NULL,
    ClientID AS (CustomerID), -- Computed column
    Amount DECIMAL(18,2) NOT NULL,
    CONSTRAINT PK_OrdersWithComputedIncluded PRIMARY KEY (OrderID)
);
GO

CREATE NONCLUSTERED INDEX IX_OrdersWithComputedIncluded_OrderDate
    ON dbo.OrdersWithComputedIncluded(OrderDate)
    INCLUDE (ClientID);  -- Computed column in INCLUDE
GO

INSERT INTO dbo.OrdersWithComputedIncluded (OrderDate, CustomerID, Amount)
VALUES 
    ('2024-01-15', 1, 100.00),
    ('2024-06-20', 2, 250.50),
    ('2025-03-10', 1, 175.25),
    ('2025-11-05', 3, 300.00);
GO

SELECT * FROM OrdersWithComputedIncluded


ALTER INDEX IX_OrdersWithComputedIncluded_OrderDate
    ON dbo.OrdersWithComputedIncluded 
    REBUILD WITH (SORT_IN_TEMPDB = OFF, ONLINE = ON, RESUMABLE = ON);

[rwestMSFT]

@ClaudioESSilva I am pretty sure this is documented somewhere, but let me check with the product group and we'll investigate. Thanks for the contribution.

[dimitri-furman]

@ClaudioESSilva thank you for finding this documentation gap!

@rwestMSFT the same change should be made in alter-index-transact-sql.md. Additionally, the You cannot create a resumable index that contains: phrase above this bulleted list should be changed as follows:

• For create: You cannot create an index using a resumable index operation if the index contains:
• For alter: You cannot rebuild an index using a resumable index operation if the index contains:

[v-regandowner]

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

[rwestMSFT]

Thanks for your contribution. We've made the change in an internal PR.