Repository navigation
Describe the tempdb data files that setup creates on SQL Server on Linux - #10478
Rudi Bruchez (rudi-bruchez) wants to merge 2 commits into
Conversation
|
Rudi Bruchez (@rudi-bruchez) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change. |
|
Learn Build status updates of commit b225b1a: ✅ Validation status: passed
For more details, please refer to the build report. |
There was a problem hiding this comment.
🟡 Changes recommended
An active documentation issue remains because the guidance omits the required caveat for in-place upgrades that may retain only one tempdb data file.
1 open issue
What changed in this PR
Updates SQL Server on Linux tempdb guidance to describe the data files created automatically by SQL Server 2019 and later, while preserving manual configuration guidance for SQL Server 2017 and Express edition.
Changes:
- Documents automatic creation of up to eight
tempdbdata files based on logical processors. - Notes that Express edition continues to use a single data file.
- Retains guidance to add files manually where setup does not create them automatically.
This pull request requires changes.
| File | Description |
|---|---|
docs/linux/configure/performance-best-practices-operating-system.md |
Updates tempdb data-file guidance for SQL Server versions and editions, but should retain the caveat for instances upgraded from SQL Server 2017. |
Review effort: Lite
| #### Configure multiple `tempdb` data files | ||
|
|
||
| Because a [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] on Linux installation doesn't offer an option to configure multiple `tempdb` files, consider creating multiple `tempdb` data files after installation. For more information, see [Recommendations to reduce allocation contention in SQL Server tempdb database](/troubleshoot/sql/database-engine/performance/recommendations-reduce-allocation-contention). | ||
| Starting with [!INCLUDE [sssql19-md](../../includes/sssql19-md.md)], a new installation of [!INCLUDE [ssnoversion-md](../../includes/ssnoversion-md.md)] on Linux creates multiple `tempdb` data files based on the number of logical processors, up to eight files. Express edition creates a single `tempdb` data file. For [!INCLUDE [sssql17-md](../../includes/sssql17-md.md)] and for Express edition, consider creating multiple `tempdb` data files after installation. For more information, see [Recommendations to reduce allocation contention in SQL Server tempdb database](/troubleshoot/sql/database-engine/performance/recommendations-reduce-allocation-contention). |
There was a problem hiding this comment.
You're right, and I measured it: a SQL Server 2017 instance upgraded in place to 2019 (15.0.4500.2) or 2025 (17.0.5035.5) on Linux still has a single tempdb data file. The paragraph now says so and extends the recommendation to upgraded instances.
|
Attinder Pal Singh (@AttinderPalSingh) Can you review the proposed changes? Important: When the changes are ready for publication, adding a #label:"aq-pr-triaged" |
|
Learn Build status updates of commit 7aad7be: ✅ Validation status: passed
For more details, please refer to the build report. |

What's wrong
The "Configure multiple
tempdbdata files" section ofdocs/linux/configure/performance-best-practices-operating-system.mdsays:The sentence dates from the SQL Server 2017 version of the article. Since SQL Server 2019, setup on Linux creates multiple
tempdbdata files on its own, based on the number of logical processors, as What's new in SQL Server 2019 on Linux already states. A reader of the current text adds files to an instance that already has them. Express edition is the exception: it still gets a single data file.Evidence
Fresh containers
mcr.microsoft.com/mssql/server,MSSQL_PIDset to each edition. The count is read once setup has finished: the error log first reports "The tempdb database has 1 data file(s)", then, a few seconds later, the final count.tempdbdata filestaskset -c 0-3taskset -c 0-1Each file is 8 MB with a 64-MB growth. Observed: from SQL Server 2019, one data file per logical processor, up to eight, except in Express. Expected per the current text: a single data file.
Change
Replaces the sentence with what setup does from SQL Server 2019, and keeps the advice to add files for SQL Server 2017 and for Express edition.