Skip to content

Clarify when to apply Orleans ADO.NET migration scripts - #56247

Open
adarsh6980 wants to merge 1 commit into
dotnet:mainfrom
adarsh6980:adarsh6980-patch-2
Open

adarsh6980 wants to merge 1 commit into
dotnet:mainfrom
adarsh6980:adarsh6980-patch-2

Conversation

@adarsh6980

@adarsh6980 adarsh6980 commented Sep 24, 2026 •

Copy link
Copy Markdown

Fixes #38870.

The ADO.NET configuration doc mentioned the migration scripts only for upgrades. This makes clear they also apply when a setup fails with errors such as System.ArgumentException: Not all required queries found, and points readers who hit that error at the scripts that bring the schema and stored queries up to date.


Internal previews

File Preview link
docs/orleans/host/configuration-guide/adonet-configuration.md Learn preview

Build report

Clarified migration script instructions for ADO.NET schema upgrades.
Copilot AI lite review requested due to automatic review settings September 24, 2026 11:31
@dotnetrepoman dotnetrepoman Bot added this to the September 2026 milestone Sep 24, 2026
@dotnet-policy-service dotnet-policy-service Bot added the community-contribution Indicates PR is created by someone from the .NET community. label Sep 24, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

The documentation-only changes are clear and address the stated issue.

Review effort: Lite
Findings: None

What changed in this PR

Clarifies when Orleans ADO.NET migration scripts are required, including setup failures caused by missing queries.

Changes:

  • Documents the Not all required queries found error.
  • Explains schema and stored-query updates.
  • Links clustering, persistence, and reminder migration scripts.
File Description
docs/​orleans/​host/​configuration-guide/​adonet-configuration.md Expands ADO.NET migration guidance.

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

The following sections contain links to SQL scripts for configuring your database and the corresponding ADO.NET invariant used to configure ADO.NET providers in Orleans. Customize these scripts as needed for your deployment. Before executing scripts for Clustering, Persistence, or Reminders, you need to create the main tables using the Main scripts.

If you are upgrading an existing ADO.NET schema, also apply the appropriate migration scripts for the providers you use:
If you are upgrading an existing ADO.NET schema, or if your setup fails with an error such as `System.ArgumentException: Not all required queries found`, also apply the appropriate migration scripts for the providers you use. These scripts bring the schema and stored queries up to date:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you are upgrading an existing ADO.NET schema, or if your setup fails with an error such as `System.ArgumentException: Not all required queries found`, also apply the appropriate migration scripts for the providers you use. These scripts bring the schema and stored queries up to date:
If you're upgrading an existing ADO.NET schema, or if your setup fails with an error such as "System.ArgumentException: Not all required queries found", also apply the appropriate migration scripts for the providers you use. These scripts bring the schema and stored queries up to date:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Indicates PR is created by someone from the .NET community.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Orleans: AdoNet Setup: Migrations scripts are missing from instructions

3 participants