Skip to content

Commit e0b9d4e

Browse files
authored
Merge pull request #115081 from MashaMSFT/move4
Move4
2 parents c8423d2 + 7194884 commit e0b9d4e

58 files changed

Lines changed: 2302 additions & 5 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: Ports beyond 1433
3+
description: Client connections from ADO.NET to Azure SQL Database can bypass the proxy and interact directly with the database using ports other than 1433.
4+
services: sql-database
5+
ms.service: sql-database
6+
ms.subservice: development
7+
ms.custom: sqldbrb=1
8+
ms.devlang:
9+
ms.topic: conceptual
10+
author: MightyPen
11+
ms.author: genemi
12+
ms.reviewer: sstein
13+
ms.date: 04/03/2019
14+
---
15+
# Ports beyond 1433 for ADO.NET 4.5
16+
17+
This topic describes the Azure SQL Database connection behavior for clients that use ADO.NET 4.5 or a later version.
18+
19+
> [!IMPORTANT]
20+
> For information about connectivity architecture, see [Azure SQL Database connectivity architecture](connectivity-architecture.md).
21+
>
22+
23+
## Outside vs inside
24+
25+
For connections to Azure SQL Database, we must first ask whether your client program runs *outside* or *inside* the Azure cloud boundary. The subsections discuss two common scenarios.
26+
27+
### *Outside:* Client runs on your desktop computer
28+
29+
Port 1433 is the only port that must be open on your desktop computer that hosts your SQL Database client application.
30+
31+
### *Inside:* Client runs on Azure
32+
33+
When your client runs inside the Azure cloud boundary, it uses what we can call a *direct route* to interact with SQL Database. After a connection is established, further interactions between the client and database involve no Azure SQL Database Gateway.
34+
35+
The sequence is as follows:
36+
37+
1. ADO.NET 4.5 (or later) initiates a brief interaction with the Azure cloud, and receives a dynamically identified port number.
38+
39+
* The dynamically identified port number is in the range of 11000-11999.
40+
2. ADO.NET then connects to SQL Database directly, with no middleware in between.
41+
3. Queries are sent directly to the database, and results are returned directly to the client.
42+
43+
Ensure that the port ranges of 11000-11999 on your Azure client machine are left available for ADO.NET 4.5 client interactions with SQL Database.
44+
45+
* In particular, ports in the range must be free of any other outbound blockers.
46+
* On your Azure VM, the **Windows Firewall with Advanced Security** controls the port settings.
47+
48+
* You can use the [firewall's user interface](https://msdn.microsoft.com/library/cc646023.aspx) to add a rule for which you specify the **TCP** protocol along with a port range with the syntax like **11000-11999**.
49+
50+
## Version clarifications
51+
52+
This section clarifies the monikers that refer to product versions. It also lists some pairings of versions between products.
53+
54+
### ADO.NET
55+
56+
* ADO.NET 4.0 supports the TDS 7.3 protocol, but not 7.4.
57+
* ADO.NET 4.5 and later supports the TDS 7.4 protocol.
58+
59+
### ODBC
60+
61+
* Microsoft SQL Server ODBC 11 or above
62+
63+
### JDBC
64+
65+
* Microsoft SQL Server JDBC 4.2 or above (JDBC 4.0 actually supports TDS 7.4 but does not implement “redirection”)
66+
67+
## Related links
68+
69+
* ADO.NET 4.6 was released on July 20, 2015. A blog announcement from the .NET team is available [here](https://devblogs.microsoft.com/dotnet/announcing-net-framework-4-6/).
70+
* ADO.NET 4.5 was released on August 15, 2012. A blog announcement from the .NET team is available [here](https://devblogs.microsoft.com/dotnet/announcing-the-release-of-net-framework-4-5-rtm-product-and-source-code/).
71+
* A blog post about ADO.NET 4.5.1 is available [here](https://devblogs.microsoft.com/dotnet/announcing-the-net-framework-4-5-1-preview/).
72+
73+
* Microsoft® ODBC Driver 17 for SQL Server® - Windows, Linux, & macOS
74+
https://www.microsoft.com/download/details.aspx?id=56567
75+
76+
* Connect to Azure SQL Database V12 via Redirection
77+
https://techcommunity.microsoft.com/t5/DataCAT/Connect-to-Azure-SQL-Database-V12-via-Redirection/ba-p/305362
78+
79+
* [TDS protocol version list](https://www.freetds.org/userguide/tdshistory.htm)
80+
* [SQL Database Development Overview](../../sql-database/sql-database-develop-overview.md)
81+
* [Azure SQL Database firewall](../../sql-database/sql-database-firewall-configure.md)

azure-sql/database/connectivity-architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,5 +115,5 @@ Details of how traffic shall be migrated to new Gateways in specific regions are
115115
## Next steps
116116

117117
- For information on how to change the Azure SQL Database connection policy for a server, see [conn-policy](https://docs.microsoft.com/cli/azure/sql/server/conn-policy).
118-
- For information about Azure SQL Database connection behavior for clients that use ADO.NET 4.5 or a later version, see [Ports beyond 1433 for ADO.NET 4.5](../../sql-database/sql-database-develop-direct-route-ports-adonet-v12.md).
118+
- For information about Azure SQL Database connection behavior for clients that use ADO.NET 4.5 or a later version, see [Ports beyond 1433 for ADO.NET 4.5](adonet-v12-develop-direct-route-ports.md).
119119
- For general application development overview information, see [SQL Database Application Development Overview](../../sql-database/sql-database-develop-overview.md).

0 commit comments

Comments
 (0)