Manage a lake

This page explains how to view, update, and delete an existing Dataplex lake.

Before you begin

• If you haven't done so already, create a lake.

Access control

• To update or delete a lake, you must be granted IAM roles containing the dataplex.lakes.create and the dataplex.lakes.delete IAM permissions respectively. The Dataplex specific roles roles/dataplex.admin and roles/dataplex.editor can be used to grant update and delete permission.

• You can also give update and delete permission to users or groups by using the roles/owner and roles/editor legacy roles.

For more information, see Dataplex IAM and access control.

View a lake

To view your Dataplex lake in the Google Cloud console, follow these steps:

1. Open the Dataplex page in the Google Cloud console:

   Open Dataplex in the Google Cloud console

2. Click the name of the lake you want to view.

   

• Zones

  You can manage existing data zones in your lake or add new data zones.

  For more information, see Managing a zone.

• Details

  You can view lake details such as the number of data items discovered, the assets in the lake, and more.

• Environments

  You can create, delete, and manage an environment.

• Permissions

  Manage lake permissions. For more information, see IAM and access control.

• Actions

  View lake-level actions, specifically issues around security policy propagation. Learn more.

Update a lake

You can update a lake by issuing a Dataplex API method lakes.patch or by editing lake details on the edit lake page opened in a local browser.

Only one update job is supported at a time, and each job can have multiple property updates. You can still use the lake while it's being updated.

The following lake parameters can be updated:

• Name
• Description
• Labels

Note: You must recreate a lake if you'd like to change lake details that can't be updated.

The following instructions demonstrate how to update a Dataplex lake using the Google Cloud console or the Dataplex API.

Console

1. In the Google Cloud console, open the Dataplex page:

   Open Dataplex in the Google Cloud console

2. On the Dataplex page, click the lake name of the lake you'd like to update. The lake page for that lake opens.

3. At the top of the page, click the Edit button. The Edit Lake page opens.

4. Choose the updated lake parameter values.

5. Click the Save button to update the lake.

6. Verify that you have returned to the Dataplex page, and that your updated lake appears in the list.

REST

Follow the API instructions to update a lake by using the APIs Explorer.

When the update succeeds, the lake automatically enters active state. If it fails, then the lake is rolled back to its previous healthy state.

Delete a lake

You can delete a lake by issuing a Dataplex API method lakes.delete or by clicking delete on the lake page opened in a local browser.

You may want to delete your lake if your configurations are wrong and can't be changed.

Lakes cannot be deleted unless all data zone resources under it have been deleted. Similarly, data zones cannot be deleted unless all asset resources under it have been deleted. Users given access to data through these lake or data zones will lose access rights.

Note: Your Cloud Storage buckets or BigQuery datasets are not deleted when you delete your lake. You must explicitly delete them if you'd like to.

The following instructions demonstrate how to delete a Dataplex lake using the Google Cloud console or the Dataplex API.

Caution: Deletion is permanent. Once deleted, lakes cannot be restored. You can, however, quickly create new Dataplex lakes as you need them.

Console

1. In the Google Cloud console, open the Dataplex page:

   Open Dataplex in the Google Cloud console

2. On the Dataplex page, click the lake name of the lake you'd like to delete. The lake page for that lake opens.

3. At the top of the page, click Delete. The Delete lake dialog opens.

4. Confirm deletion by typing "delete".

5. Click Delete Lake on to confirm the deletion.

6. Verify that you have returned to the Dataplex page, and that your deleted lake no longer appears in the list.

REST

Follow the API instructions to delete a lake by using the APIs Explorer.

All deletions cannot be undone and may take a while to complete.

What's next?

• Learn more about managing a zone.
• Learn more about managing and attaching buckets.
• Learn more about Cloud Audit Logs.