docs: Address 10 UUF items across SQL connectivity and security articles (#36965)

- Add deb package download troubleshooting to ODBC Linux install guide
- Add Azure Linux repository pre-configuration note
- Add Apple Silicon M1/M2/M3 terminology and iODBC compatibility warning
- Add Oracle Linux compatibility note to PHP driver install tutorial
- Add cross-instance Kerberos integrated security example (CREATE DB SCOPED CREDENTIAL)
- Add system table modification warning with sp_change_agent_parameter reference
- Add ResultSet constant descriptions to JDBC createStatement parameters
- Add DatabaseMetaData usage code example with getTables pattern
- Add quick-start ODBC connection string examples for common scenarios

Author: VanMSFT

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)