Copilot in SSMA for Oracle (#34116)

Author: rwestMSFT

docs/ssma/oracle/copilot-in-ssma-overview.md

@@ -0,0 +1,84 @@
+---
+title: What Is Microsoft Copilot in SSMA for Oracle?
+description: Learn how Copilot in SQL Server Migration Assistant (SSMA) provides intelligent, AI-powered assistance for complex or unsupported objects.
+author: nilabjaball
+ms.author: niball
+ms.reviewer: randolphwest
+ms.date: 05/15/2025
+ms.service: sql
+ms.subservice: ssma
+ms.topic: overview
+ms.collection:
+  - ce-skilling-ai-copilot
+---
+
+# What is Microsoft Copilot in SSMA for Oracle (Preview)?
+
+Copilot in SQL Server Migration Assistant (SSMA) enhances the code conversion process from Oracle to SQL by providing intelligent, AI-powered assistance for complex or unsupported objects. When the SSMA rule engine encounters conversion challenges, such as syntax differences, proprietary Oracle features, or unsupported data types, Copilot steps in to analyze the issue, explain the root cause, and generate alternative SQL-compatible code.
+
+By integrating with Azure OpenAI, Copilot in SSMA for Oracle (Preview) allows you to review, refine, and validate the suggested code directly within the SSMA interface, streamlining the migration process and reducing manual effort.
+
+## Prerequisites
+
+To use Copilot in SSMA for Oracle (Preview) for code conversion, ensure you have the following Azure OpenAI resource details:
+
+- Azure OpenAI Endpoint URL
+- Azure OpenAI Deployment
+- Model Name
+- Azure OpenAI Key
+
+If you don't have these details, follow the steps in the [How to create Azure OpenAI resource](#modify-azure-openai-settings) section.
+
+## Steps to run Copilot in SSMA for Oracle (Preview)
+
+Once the code conversion is done, the target objects that the SSMA rule engine couldn't convert, display warnings or errors. For those objects, you can launch **Fix with Copilot**.
+
+If the OpenAI resource isn't registered, you need to complete the following fields:
+
+- Azure OpenAI Endpoint URL
+- Azure OpenAI Deployment
+- Model Name
+- Azure OpenAI Key
+
+:::image type="content" source="media/copilot-in-ssma-overview/validate-endpoint.png" alt-text="Screenshot of Validate endpoint dialog.":::
+
+Once the validation is successful, you can view the converted code. It takes a few minutes to generate the converted code. After the code is generated, you can review the suggested changes.
+
+## Code conversion interface
+
+The Code Conversion window has three sections:
+
+| Section | Description |
+| --- | --- |
+| **Errors to fix** | This section shows the possible issues identified or errors to fix that SSMA rule engine couldn't convert or failed to parse the PL/SQL statement. |
+| **Explanation** | Provides root cause of conversion issues, describing the logic behind its suggestions, and offering clear, contextual insights to help you understand and validate the generated Transact-SQL code. |
+| **Code review window** | Allows you to view side-by-side differences between SSMA-generated and Copilot-converted code. It highlights changes, enabling you to evaluate improvements, understand modifications, and make informed decisions before accepting suggestions. |
+
+:::image type="content" source="media/copilot-in-ssma-overview/compare-code.png" alt-text="Screenshot of code comparison dialog." lightbox="media/copilot-in-ssma-overview/compare-code.png":::
+
+You can retry or send additional information in the prompt if they aren't satisfied with the conversion. If the converted code is suitable, you can accept the suggestions.
+
+## Manage accepted changes in the IDE
+
+Once you review and accept the Copilot-generated code, you can find the accepted changes in the SSMA IDE. Follow these steps to save and synchronize the changes with your database:
+
+1. Navigate to the SSMA IDE where the accepted changes are displayed.
+1. Save the changes to ensure they're stored locally.
+1. Use the synchronization feature to replicate the changes to your database.
+
+## Modify Azure OpenAI settings
+
+If you need to change the Azure OpenAI details, go to **Tools** > **Project Settings** > **Copilot** in the SSMA menu. Update the **Azure OpenAI Endpoint**, **Azure OpenAI Deployment**, **Model Name**, and **Azure OpenAI Key** as required.
+
+## Review and validation
+
+As this code is generated by AI, it's crucial to review, validate, and test the changes before accepting or saving them. Ensure that the code meets your requirements, and functions correctly in your environment.
+
+## Limitations
+
+Copilot-generated code for tables and user-defined data types can't be saved directly in SSMA. In such cases, SSMA provides a download option to save the Copilot-generated code locally.
+
+## Related content
+
+- [What's new in SSMA for Oracle (OracleToSQL)](what-s-new-in-ssma-for-oracle-oracletosql.md)
+- [Microsoft Copilot in Azure with Azure SQL Database](/azure/azure-sql/copilot/copilot-azure-sql-overview)

docs/ssma/oracle/media/copilot-in-ssma-overview/compare-code.png

@@ -1,5 +1,7 @@
 - name: Overview
   href: sql-server-migration-assistant-for-oracle-oracletosql.md
+- name: Copilot in SSMA for Oracle (Preview)
+  href: copilot-in-ssma-overview.md
 - name: What's new
   items:
   - name: What's new in SSMA  

docs/ssma/oracle/media/copilot-in-ssma-overview/validate-endpoint.png

@@ -4,7 +4,7 @@ description: Find out about changes to SQL Server Migration Assistant (SSMA) for
 author: cpichuka
 ms.author: cpichuka
 ms.reviewer: randolphwest
-ms.date: 04/01/2025
+ms.date: 05/15/2025
 ms.service: sql
 ms.subservice: ssma
 ms.topic: whats-new
@@ -19,6 +19,12 @@ This article lists SQL Server Migration Assistant (SSMA) for Oracle changes in e
 
 [!INCLUDE [entra-id](../../includes/entra-id-hard-coded.md)]
 
+## SSMA v10.2
+
+The v10.2 release of SSMA for Oracle contains the following changes:
+
+- AI-assisted code code conversion with Microsoft Copilot in SSMA for Oracle (Preview)
+
 ## SSMA v10.1
 
 The v10.1 release of SSMA for Oracle contains the following changes: