changes from feedback

Author: liwong88

docs-ref-services/sql.md

@@ -4,7 +4,7 @@ description: Connect to Azure SQL database using the ODBC driver and pyodbc or m
 author: lisawong19  
 ms.author: liwong
 manager: routlaw
-ms.date: 01/05/2018
+ms.date: 01/09/2018
 ms.topic: reference
 ms.devlang: python
 ms.service: sql-database
@@ -14,47 +14,62 @@ ms.service: sql-database
 
 ## Overview
 
-Work with data stored in [Azure SQL Database](/azure/sql-database/sql-database-technical-overview) from Python with the Microsoft ODBC driver and pyodbc. View our [quickstart](https://docs.microsoft.com/azure/sql-database/sql-database-connect-query-python) and getting started [sample](https://github.com/Azure-Samples/sql-database-python-manage).
+Work with data stored in [Azure SQL Database](/azure/sql-database/sql-database-technical-overview) from Python with the pyodbc [ODBC database driver](https://github.com/mkleehammer/pyodbc/wiki/Drivers-and-Driver-Managers). View our [quickstart](https://docs.microsoft.com/azure/sql-database/sql-database-connect-query-python) on connecting to an Azure SQL database and using Transact-SQL statements to query data and getting started [sample](https://github.com/mkleehammer/pyodbc/wiki/Getting-started) with pyodbc.
+
+
+## Connecting to ORMs
+
+pyodbc works with other ORMs such as [SQLAlchemy](http://docs.sqlalchemy.org/en/latest/dialects/mssql.html?highlight=pyodbc#module-sqlalchemy.dialects.mssql.pyodbc) and [Django](https://github.com/lionheart/django-pyodbc/). 
+
 
 ## Install ODBC driver and pyodbc
 
 ```bash
 pip install pyodbc
 ```
-More details about installing the python and database communication libraries can be found [here](https://docs.microsoft.com/azure/sql-database/sql-database-connect-query-python#install-the-python-and-database-communication-libraries).
+More [details](https://docs.microsoft.com/azure/sql-database/sql-database-connect-query-python#install-the-python-and-database-communication-libraries) about installing the python and database communication libraries.
 
-### Connect and execute an SQL query
+## Connect and execute a SQL query
 
-Connect to a SQL database and select all records in a table.
+### Connect to a SQL database
 
 ```python
-import pyodbc 
+import pyodbc
 
-SERVER = 'YOUR_SERVER_NAME.database.windows.net'
-DATABASE = 'YOUR_DATABASE_NAME'
-USERNAME = 'YOUR_DB_USERNAME'
-PASSWORD = 'YOUR_DB_PASSWORD'
+server = 'your_server.database.windows.net'
+database = 'your_database'
+username = 'your_username'
+password = 'your_password'
+driver= '{ODBC Driver 13 for SQL Server}'
 
-DRIVER= '{ODBC Driver 13 for SQL Server}'
-cnxn = pyodbc.connect('DRIVER=' + DRIVER + ';PORT=1433;SERVER=' + SERVER +
-    ';PORT=1443;DATABASE=' + DATABASE + ';UID=' + USERNAME + ';PWD=' + PASSWORD)
+cnxn = pyodbc.connect('DRIVER='+driver+';PORT=1433;SERVER='+server+';PORT=1443;DATABASE='+database+';UID='+username+';PWD='+ password)
 cursor = cnxn.cursor()
-selectsql = "SELECT * FROM SALES"  # SALES is an example table name
-cursor.execute(selectsql)
 ```
 
-## Management API
+### Execute a SQL query
+
+```python
+cursor.execute("SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName FROM [SalesLT].[ProductCategory] pc JOIN [SalesLT].[Product] p ON pc.productcategoryid = p.productcategoryid")
+row = cursor.fetchone()
+while row:
+    print (str(row[0]) + " " + str(row[1]))
+    row = cursor.fetchone()
+```
+
+> [!div class="nextstepaction"]
+> [pyodbc sample]()
+
+## [Management API](/python/api/overview/azure/sql/managementlibrary)
 
 Create and manage Azure SQL Database resources in your subscription with the management API. 
 
 ```bash
-pip install azure-mgmt-sql
 pip install azure-common
 pip install azure-mgmt-sql
 pip install azure-mgmt-resource
 ```
 
-### Example
+## Example
 
 Create a SQL Database resource and restrict access to a range of IP addresses using a firewall rule.