Skip to content

Commit bfde1e5

Browse files
committed
Refine sections
1 parent 79bccc1 commit bfde1e5

File tree

1 file changed

+33
-31
lines changed

1 file changed

+33
-31
lines changed

articles/purview/register-scan-synapse-workspace.md

Lines changed: 33 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -242,9 +242,40 @@ GRANT REFERENCES ON DATABASE SCOPED CREDENTIAL::[scoped_credential] TO [PurviewA
242242
1. Select **Save**.
243243

244244
> [!IMPORTANT]
245-
> Currently, if you cannot enable **Allow Azure services and resources to access this workspace** on your Azure Synapse workspaces, when set up scan on Microsoft Purview governance portal, you will hit serverless DB enumeration failure. In this case, to scan serverless DBs, you can use [Microsoft Purview REST API - Scans - Create Or Update](/rest/api/purview/scanningdataplane/scans/create-or-update/) to set up scan. See below example.
245+
> Currently, if you cannot enable **Allow Azure services and resources to access this workspace** on your Azure Synapse workspaces, when set up scan on Microsoft Purview governance portal, you will hit serverless DB enumeration failure. In this case, to scan serverless DBs, you can use [Microsoft Purview REST API - Scans - Create Or Update](/rest/api/purview/scanningdataplane/scans/create-or-update/) to set up scan. Refer to [this example](#set-up-scan-using-api).
246246

247-
Example of creating scan for serverless DB using API, replace the `{place_holder}` and `enum_option_1 | enum_option_2 (note)` value with your actual settings:
247+
### Create and run scan
248+
249+
To create and run a new scan, do the following:
250+
251+
1. Select the **Data Map** tab on the left pane in [the Microsoft Purview governance portal](https://web.purview.azure.com/resource/).
252+
253+
1. Select the data source that you registered.
254+
255+
1. Select **View details**, and then select **New scan**. Alternatively, you can select the **Scan quick action** icon on the source tile.
256+
257+
1. On the **Scan** details pane, in the **Name** box, enter a name for the scan.
258+
1. In the **Type** dropdown list, select the types of resources that you want to scan within this source. **SQL Database** is the only type we currently support within an Azure Synapse workspace.
259+
260+
:::image type="content" source="media/register-scan-synapse-workspace/synapse-scan-setup.png" alt-text="Screenshot of the details pane for the Azure Synapse source scan.":::
261+
262+
1. In the **Credential** dropdown list, select the credential to connect to the resources within your data source.
263+
264+
1. Within each type, you can select to scan either all the resources or a subset of them by name.
265+
266+
1. Select **Continue** to proceed.
267+
268+
1. Select **Scan rule sets** of type **Azure Synapse SQL**. You can also create scan rule sets inline.
269+
270+
1. Choose your scan trigger. You can schedule it to run **weekly/monthly** or **once**.
271+
272+
1. Review your scan, and then select **Save** to complete the setup.
273+
274+
[!INCLUDE [create and manage scans](includes/view-and-manage-scans.md)]
275+
276+
### Set up scan using API
277+
278+
Here is an example of creating scan for serverless DB using API. Replace the `{place_holder}` and `enum_option_1 | enum_option_2 (note)` value with your actual settings.
248279

249280
```http
250281
PUT https://{purview_account_name}.purview.azure.com/scan/datasources/<data_source_name>/scans/{scan_name}?api-version=2022-02-01-preview
@@ -281,35 +312,6 @@ PUT https://{purview_account_name}.purview.azure.com/scan/datasources/<data_sour
281312

282313
To schedule the scan, additionally create a trigger for it after scan creation, refer to [Triggers - Create Trigger](/rest/api/purview/scanningdataplane/triggers/create-trigger).
283314

284-
### Create and run scan
285-
286-
To create and run a new scan, do the following:
287-
288-
1. Select the **Data Map** tab on the left pane in [the Microsoft Purview governance portal](https://web.purview.azure.com/resource/).
289-
290-
1. Select the data source that you registered.
291-
292-
1. Select **View details**, and then select **New scan**. Alternatively, you can select the **Scan quick action** icon on the source tile.
293-
294-
1. On the **Scan** details pane, in the **Name** box, enter a name for the scan.
295-
1. In the **Type** dropdown list, select the types of resources that you want to scan within this source. **SQL Database** is the only type we currently support within an Azure Synapse workspace.
296-
297-
:::image type="content" source="media/register-scan-synapse-workspace/synapse-scan-setup.png" alt-text="Screenshot of the details pane for the Azure Synapse source scan.":::
298-
299-
1. In the **Credential** dropdown list, select the credential to connect to the resources within your data source.
300-
301-
1. Within each type, you can select to scan either all the resources or a subset of them by name.
302-
303-
1. Select **Continue** to proceed.
304-
305-
1. Select **Scan rule sets** of type **Azure Synapse SQL**. You can also create scan rule sets inline.
306-
307-
1. Choose your scan trigger. You can schedule it to run **weekly/monthly** or **once**.
308-
309-
1. Review your scan, and then select **Save** to complete the setup.
310-
311-
[!INCLUDE [create and manage scans](includes/view-and-manage-scans.md)]
312-
313315
## Next steps
314316

315317
Now that you've registered your source, follow the below guides to learn more about Microsoft Purview and your data.

0 commit comments

Comments
 (0)