Merge pull request #36979 from MicrosoftDocs/main

Auto Publish – main to live - 2026-03-30 22:30 UTC

Author: learn-build-service-prod[bot]

azure-sql/database/elastic-pool-manage.md

@@ -113,4 +113,4 @@ To create and manage SQL Database elastic pools and pooled databases, use these
 
 ## Related content
 
-- To learn more about design patterns for SaaS applications using elastic pools, see [Design Patterns for Multi-tenant SaaS Applications with Azure SQL Database](saas-tenancy-app-design-patterns.md).
+- To learn more about design patterns for SaaS applications using elastic pools, see [Design Patterns for multitenant SaaS Applications with Azure SQL Database](saas-tenancy-app-design-patterns.md).

azure-sql/database/elastic-scale-shard-map-management.md

@@ -39,11 +39,11 @@ For a single-tenant model, create a **list-mapping** shard map. The single-tenan
 
 :::image type="content" source="media/elastic-scale-shard-map-management/listmapping.png" alt-text="Diagram of List mapping.":::
 
-The multi-tenant model assigns several tenants to an individual database (and you can distribute groups of tenants across multiple databases). Use this model when you expect each tenant to have small data needs. In this model, assign a range of tenants to a database using **range mapping**.
+The multitenant model assigns several tenants to an individual database (and you can distribute groups of tenants across multiple databases). Use this model when you expect each tenant to have small data needs. In this model, assign a range of tenants to a database using **range mapping**.
 
 :::image type="content" source="media/elastic-scale-shard-map-management/rangemapping.png" alt-text="Diagram of Range mapping.":::
 
-Or you can implement a multi-tenant database model using a *list mapping* to assign multiple tenants to an individual database. For example, DB1 is used to store information about tenant ID 1 and 5, and DB2 stores data for tenant 7 and tenant 10.
+Or you can implement a multitenant database model using a *list mapping* to assign multiple tenants to an individual database. For example, DB1 is used to store information about tenant ID 1 and 5, and DB2 stores data for tenant 7 and tenant 10.
 
 :::image type="content" source="media/elastic-scale-shard-map-management/multipleonsingledb.png" alt-text="Diagram of Multiple tenants on single DB.":::
 

azure-sql/database/saas-tenancy-app-design-patterns.md

@@ -80,7 +80,7 @@ The vendor can access all the databases in all the standalone app instances, eve
 
 This next pattern uses a multitenant application with many databases, all being single-tenant databases. A new database is provisioned for each new tenant. The application tier is scaled *up* vertically by adding more resources per node. Or the app is scaled *out* horizontally by adding more nodes. The scaling is based on workload, and is independent of the number or scale of the individual databases.
 
-:::image type="content" source="media/saas-tenancy-app-design-patterns/saas-multi-tenant-app-database-per-tenant.png" alt-text="Diagram of the design of a multi-tenant app with database-per-tenant.":::
+:::image type="content" source="media/saas-tenancy-app-design-patterns/saas-multi-tenant-app-database-per-tenant.png" alt-text="Diagram of the design of a multitenant app with database-per-tenant.":::
 
 ### Customize for a tenant
 
@@ -92,7 +92,7 @@ With database-per-tenant, customizing the schema for one or more individual tena
 
 When databases are deployed in the same resource group, they can be grouped into elastic pools. The pools provide a cost-effective way of sharing resources across many databases. This pool option is cheaper than requiring each database to be large enough to accommodate the usage peaks that it experiences. Even though pooled databases share access to resources they can still achieve a high degree of performance isolation.
 
-:::image type="content" source="media/saas-tenancy-app-design-patterns/saas-multi-tenant-app-database-per-tenant-pool.png" alt-text="Diagram of the design of multi-tenant app with database-per-tenant, using elastic pool.":::
+:::image type="content" source="media/saas-tenancy-app-design-patterns/saas-multi-tenant-app-database-per-tenant-pool.png" alt-text="Diagram of the design of multitenant app with database-per-tenant, using elastic pool.":::
 
 Azure SQL Database provides the tools necessary to configure, monitor, and manage the sharing. Both pool-level and database-level performance metrics are available in the Azure portal, and through Azure Monitor logs. The metrics can give great insights into both aggregate and tenant-specific performance. Individual databases can be moved between pools to provide reserved resources to a specific tenant. These tools enable you to ensure good performance in a cost effective manner.
 
@@ -141,7 +141,7 @@ Management operations that are focused on individual tenants are more complex to
 
 Most SaaS applications access the data of only one tenant at a time. This access pattern allows tenant data to be distributed across multiple databases or shards, where all the data for any one tenant is contained in one shard. Combined with a multitenant database pattern, a sharded model allows almost limitless scale.
 
-:::image type="content" source="media/saas-tenancy-app-design-patterns/saas-multi-tenant-app-sharded-multi-tenant-databases.png" alt-text="Diagram of the design of a multi-tenant app with sharded multi-tenant databases.":::
+:::image type="content" source="media/saas-tenancy-app-design-patterns/saas-multi-tenant-app-sharded-multi-tenant-databases.png" alt-text="Diagram of the design of a multitenant app with sharded multitenant databases.":::
 
 ### Manage shards
 

docs/connect/jdbc/reference/createstatement-method-int-int.md

@@ -3,7 +3,7 @@ title: "createStatement Method (int, int)"
 description: "createStatement Method (int, int)"
 author: David-Engel
 ms.author: davidengel
-ms.date: "01/19/2017"
+ms.date: 03/27/2026
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: reference
@@ -24,16 +24,27 @@ public java.sql.Statement createStatement(int resultSetType,
                                           int resultSetConcurrency)  
 ```  
 
-#### Parameters  
- *resultSetType*  
-  
- The **int** value representing the result set type.  
-  
- *resultSetConcurrency*  
-  
- The **int** value representing the result set concurrency type.  
+#### Parameters
+ *resultSetType*
+
+ The **int** value representing the result set type. Use one of the following `java.sql.ResultSet` constants:
+
+ | Constant | Description |
+ |---|---|
+ | `ResultSet.TYPE_FORWARD_ONLY` | Cursor moves forward only. Best performance for sequential reads. |
+ | `ResultSet.TYPE_SCROLL_INSENSITIVE` | Scrollable result set that doesn't reflect changes made to the underlying data after the result set is created. |
+ | `ResultSet.TYPE_SCROLL_SENSITIVE` | Scrollable result set that reflects changes made to the underlying data. |
+
+ *resultSetConcurrency*
+
+ The **int** value representing the result set concurrency type. Use one of the following `java.sql.ResultSet` constants:
+
+ | Constant | Description |
+ |---|---|
+ | `ResultSet.CONCUR_READ_ONLY` | The result set can't be updated. |
+ | `ResultSet.CONCUR_UPDATABLE` | The result set can be updated by using positioned updates and deletes. |  
 
-## Return Value  
+## Return value  
  The Statement object.  
 
 ## Exceptions  
@@ -42,9 +53,8 @@ public java.sql.Statement createStatement(int resultSetType,
 ## Remarks  
  This createStatement method is specified by the createStatement method in the java.sql.Connection interface.  
 
-## See Also  
- [createStatement Method (SQLServerConnection)](../../../connect/jdbc/reference/createstatement-method-sqlserverconnection.md)   
- [SQLServerConnection Members](../../../connect/jdbc/reference/sqlserverconnection-members.md)   
- [SQLServerConnection Class](../../../connect/jdbc/reference/sqlserverconnection-class.md)  
-  
-  
+## Related content
+
+- [createStatement Method (SQLServerConnection)](../../../connect/jdbc/reference/createstatement-method-sqlserverconnection.md)
+- [SQLServerConnection Members](../../../connect/jdbc/reference/sqlserverconnection-members.md)
+- [SQLServerConnection Class](../../../connect/jdbc/reference/sqlserverconnection-class.md)

docs/connect/jdbc/reference/sqlserverdatabasemetadata-members.md

@@ -3,7 +3,7 @@ title: "SQLServerDatabaseMetaData Members"
 description: "SQLServerDatabaseMetaData Members"
 author: David-Engel
 ms.author: davidengel
-ms.date: "01/19/2017"
+ms.date: 03/27/2026
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: reference
@@ -12,8 +12,22 @@ ms.custom: sfi-ropc-nochange
 # SQLServerDatabaseMetaData Members
 [!INCLUDE[Driver_JDBC_Download](../../../includes/driver_jdbc_download.md)]
 
-  The following tables list the members that are exposed by the [SQLServerDatabaseMetaData](../../../connect/jdbc/reference/sqlserverdatabasemetadata-class.md) class.  
-  
+The following tables list the members that are exposed by the [SQLServerDatabaseMetaData](../../../connect/jdbc/reference/sqlserverdatabasemetadata-class.md) class.
+
+> [!TIP]
+> To use these methods, first obtain a `DatabaseMetaData` object from an active connection:
+>
+> ```java
+> Connection conn = DriverManager.getConnection(connectionUrl);
+> DatabaseMetaData dbmd = conn.getMetaData();
+>
+> // Example: list all tables in the database
+> ResultSet rs = dbmd.getTables(null, null, "%", new String[]{"TABLE"});
+> while (rs.next()) {
+>     System.out.println(rs.getString("TABLE_NAME"));
+> }
+> ```
+
 ## Constructors  
  None.  
   
@@ -208,7 +222,6 @@ ms.custom: sfi-ropc-nochange
 |java.lang.Object|clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait|  
 |java.sql.Wrapper|isWrapperFor, unwrap|  
   
-## See Also  
- [SQLServerDatabaseMetaData Class](../../../connect/jdbc/reference/sqlserverdatabasemetadata-class.md)  
-  
-  
+## Related content
+
+- [SQLServerDatabaseMetaData Class](../../../connect/jdbc/reference/sqlserverdatabasemetadata-class.md)

docs/connect/odbc/linux-mac/install-microsoft-odbc-driver-sql-server-macos.md

@@ -21,9 +21,11 @@ This article explains how to install the Microsoft ODBC Driver for SQL Server on
 
 This article provides commands for installing the ODBC driver from the bash shell. If you want to download the packages directly, see [Download ODBC Driver for SQL Server](../download-odbc-driver-for-sql-server.md).
 
-> [!NOTE]  
-> The Microsoft ODBC driver for SQL Server on macOS is only supported on the x64 architecture through version 17.7. Apple ARM64 support was added starting with version 17.8. The architecture will be detected and the correct package will be automatically installed by the Homebrew formula. If your command prompt is running in x64 emulation mode on ARM64, the x64 package will be installed. If you're not running in emulation mode in your command prompt, the ARM64 package will be installed.
+> [!NOTE]
+> The Microsoft ODBC driver for SQL Server on macOS is only supported on the x64 architecture through version 17.7. Apple ARM64 (M1, M2, M3, and later Apple Silicon chips) support was added starting with version 17.8. The Homebrew formula detects the architecture and automatically installs the correct package. If your command prompt is running in x64 emulation mode on ARM64, the x64 package is installed. If you aren't running in emulation mode, the ARM64 package is installed.
 > Additionally, the Homebrew default directory changed with the ARM64 architecture, to `/opt/homebrew`. The paths in the [Driver files](#driver-files) section use the x64 Homebrew paths, which default to `/usr/local`, so your file paths will vary accordingly.
+>
+> The Microsoft ODBC driver for macOS is designed to work with **unixODBC** (installed by Homebrew). If you use **iODBC** as your driver manager, you might encounter architecture mismatch errors such as `incompatible architecture (have 'arm64', need 'x86_64')`. To resolve this issue, use unixODBC instead of iODBC. Homebrew automatically installs unixODBC as a dependency of the `msodbcsql18` package.
 
 ## Microsoft ODBC 18
 

docs/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server.md

@@ -4,7 +4,7 @@ description: Learn how to install the Microsoft ODBC Driver for SQL Server on Li
 author: David-Engel
 ms.author: davidengel
 ms.reviewer: randolphwest
-ms.date: 01/06/2026
+ms.date: 03/27/2026
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: concept-article
@@ -186,6 +186,9 @@ sudo apt-get install -y unixodbc-dev
 
 ### [Azure Linux](#tab/azure18-install)
 
+> [!NOTE]
+> Azure Linux 3.0 includes the Microsoft packages repository by default. You don't need to manually configure the repository before you install the driver. If your Azure Linux image uses `tdnf` as the package manager, the following commands work directly.
+
 ```bash
 if ! [[ "3.0" == *"$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)"* ]];
 then
@@ -721,6 +724,8 @@ The driver needs to load the resource file to function. This file is called `mso
 
 ## Troubleshoot
 
+### Previous driver version conflict
+
 If you previously installed and registered a version of the driver with unixODBC, installation might fail with an error similar to:
 
 ```output
@@ -735,6 +740,44 @@ odbcinst -u -d -n "ODBC Driver $1 for SQL Server"
 
 If uninstalling by using the `odbcinst` command fails, you can manually remove driver sections from the `odbcinst.ini` file. You can find the location of the `odbcinst.ini` file by using the command `odbcinst -j`.
 
+### Package download errors on Debian and Ubuntu
+
+On Debian-based distributions, you might see the following error when you install the `packages-microsoft-prod.deb` package:
+
+```output
+dpkg-deb: error: 'packages-microsoft-prod.deb' is not a Debian format archive
+```
+
+This error typically means the downloaded file is corrupted or incomplete, often caused by a network interruption or proxy issue. To resolve the problem:
+
+1. Delete the corrupted file and download it again. For Ubuntu:
+
+   ```bash
+   rm packages-microsoft-prod.deb
+   curl -sSL -O https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
+   ```
+
+   For Debian, replace `ubuntu` and use the major version number only:
+
+   ```bash
+   rm packages-microsoft-prod.deb
+   curl -sSL -O https://packages.microsoft.com/config/debian/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2 | cut -d '.' -f 1)/packages-microsoft-prod.deb
+   ```
+
+1. Verify the download is a valid Debian package (the output should include `Debian binary package`):
+
+   ```bash
+   file packages-microsoft-prod.deb
+   ```
+
+1. If the download continues to fail, check your network connection and proxy settings, or use `wget` instead of `curl`:
+
+   ```bash
+   wget https://packages.microsoft.com/config/ubuntu/$(grep VERSION_ID /etc/os-release | cut -d '"' -f 2)/packages-microsoft-prod.deb
+   ```
+
+### Connection problems
+
 If you can't make a connection to SQL Server by using the ODBC driver, see the known issues article on [troubleshooting connection problems](known-issues-in-this-version-of-the-driver.md#connectivity).
 
 ## Related content

docs/connect/php/installation-tutorial-linux-mac.md

@@ -3,7 +3,7 @@ title: "Linux and macOS Installation for the Drivers for PHP"
 description: "In these instructions, learn how to install the Microsoft Drivers for PHP for SQL Server on Linux or macOS."
 author: David-Engel
 ms.author: davidengel
-ms.date: 02/24/2026
+ms.date: 03/27/2026
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: how-to
@@ -399,7 +399,7 @@ To test your installation, see [Testing your installation](#testing-your-install
 If you don't already have it, install brew as follows:
 
 ```bash
-/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 ```
 
 > [!NOTE]
@@ -482,7 +482,7 @@ sudo apachectl restart
 
 To test your installation, see [Testing your installation](#testing-your-installation) at the end of this document.
 
-## Testing Your Installation
+## Testing your installation
 
 To test this sample script, create a file called testsql.php in your system's document root. This path is `/var/www/html/` on Ubuntu, Debian, and Red Hat, `/srv/www/htdocs` on SUSE, `/var/www/localhost/htdocs` on Alpine, or `/usr/local/var/www` on macOS. Copy the following script to it, replacing the server, database, username, and password as appropriate.
 
@@ -600,10 +600,8 @@ php testsql.php
 
 If running from the command line is successful but nothing shows in your browser, check the [Apache log files](https://linuxize.com/post/apache-log-files/#location-of-the-log-files). For more help, see [Support resources](support-resources-for-the-php-sql-driver.md) for places to go.
 
-## See Also
+## Related content
 
-[Getting Started with the Microsoft Drivers for PHP for SQL Server](../../connect/php/getting-started-with-the-php-sql-driver.md)
-
-[Loading the Microsoft Drivers for PHP for SQL Server](../../connect/php/loading-the-php-sql-driver.md)
-
-[System Requirements for the Microsoft Drivers for PHP for SQL Server](../../connect/php/system-requirements-for-the-php-sql-driver.md)
+- [Getting Started with the Microsoft Drivers for PHP for SQL Server](../../connect/php/getting-started-with-the-php-sql-driver.md)
+- [Loading the Microsoft Drivers for PHP for SQL Server](../../connect/php/loading-the-php-sql-driver.md)
+- [System Requirements for the Microsoft Drivers for PHP for SQL Server](../../connect/php/system-requirements-for-the-php-sql-driver.md)