FEAT: Complex data type support- uniqueidentifier

[gargsaumya]

Work Item / Issue Reference

AB#34945

GitHub Issue: #241

---

Summary

This pull request adds comprehensive support for Python's uuid.UUID type when interacting with SQL Server UNIQUEIDENTIFIER columns. It updates both the parameter binding and result retrieval logic to handle UUIDs as native Python objects, ensuring correct type mapping, byte order, and conversion in both directions. Additionally, new tests are introduced to verify correct insertion and retrieval of UUID values, including edge cases with None.

UUID/UNIQUEIDENTIFIER Support Improvements:

• Added logic in mssql_python/cursor.py to map Python uuid.UUID objects to the correct SQL types and convert them to raw bytes before sending to SQL Server. [1] [2]
• Updated the C++ binding layer (mssql_python/pybind/ddbc_bindings.cpp) to correctly marshal UUIDs between Python and SQL Server, including proper byte order conversion and error handling for incorrect UUID sizes.
• Enhanced result fetching in the C++ layer to convert SQL Server UNIQUEIDENTIFIER columns back into Python uuid.UUID objects, both for single-row and batch fetches, and to handle NULL values gracefully. [1] [2]

Testing Enhancements:

• Added new tests in tests/test_004_cursor.py to verify correct insertion, retrieval, and handling of None values in UUID columns, as well as round-trip integrity for multiple UUIDs. [1] [2]

[Copilot]

Pull Request Overview

This PR adds comprehensive support for Python's uuid.UUID type when working with SQL Server UNIQUEIDENTIFIER columns. It enables native UUID handling for both parameter binding and result retrieval.

• Added parameter mapping for UUID objects to SQL_GUID type in cursor.py
• Implemented UUID byte conversion and marshaling in the C++ binding layer
• Enhanced result fetching to return Python UUID objects instead of raw bytes
• Added comprehensive test coverage for UUID operations including NULL handling

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
mssql_python/cursor.py	Maps UUID parameters to SQL_GUID type and converts UUID objects to bytes
mssql_python/pybind/ddbc_bindings.cpp	Implements UUID parameter binding and result conversion with proper byte order handling
tests/test_004_cursor.py	Adds test cases for UUID insertion, retrieval, and NULL value handling

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[sumitmsft]

Left a few comments