Managing LakeFormation Data Sources

Prerequisites

• A LakeFormation instance is available. For details, see Creating an Instance.
• Access the LakeFormation console, click Clients, and create a client. For details, see Managing Clients.
• Create an agency with LakeFormation permissions (including the minimum permissions). For details, see Data Permission Management.
• For an IAM user to use GaussDB(DWS) to call APIs on the LakeFormation management plane, the user must have LakeFormation permissions (at least lakeformation:instance:access and lakeformation:instance:describe).

Creating a LakeFormation Data Source

1. Log in to the DWS console.
2. Choose Dedicated Clusters > Clusters.
3. In the cluster list, click the name of a cluster. On the page that is displayed, choose Data Sources > LakeFormation Data Sources.
4. Click Create LakeFormation Data Source Connection and configure parameters.
   Figure 1 Creating a LakeFormation data source connection
   

   Table 1 LakeFormation data source connection parameters

   Parameter	Description
   Data Source	Name of the LakeFormation data source connection to be created
   LakeFormation Instance	LakeFormation cluster instance to be bound
   Database	Database where the LakeFormation data source connection is to be created
   Agency	An agency authorized by LakeFormation. GaussDB(DWS) interacts with LakeFormation through this agency token o obtain metadata.
   Description	Description about the LakeFormation data source connection

5. Confirm the settings and click OK. The creation takes about 1 minute.

Updating a Configuration

Scenario

• After a data source connection is created, its VPC endpoint is deleted by mistake and the data source cannot be used.
• The agency needs to be changed.
• A token fails to be updated. After this issue is fixed, the token needs to be updated immediately.

Procedure

1. Log in to the DWS console.
2. Choose Dedicated Clusters > Clusters.
3. In the cluster list, click the name of a cluster. On the page that is displayed, choose Data Sources > LakeFormation Data Sources.
4. In the Operation column of a LakeFormation data source, click Update Configuration.
5. During the update, you can only change the agency. After confirming that the agency is correct, click OK to submit the update. The update takes about 1 minute.
   Figure 2 Updating a LakeFormation data source connection
   

Deleting a LakeFormation Data Source

1. Log in to the DWS console.
2. Choose Dedicated Clusters > Clusters.
3. In the cluster list, click the name of a cluster. On the page that is displayed, choose Data Sources > LakeFormation Data Sources.
4. In the Operation column of a LakeFormation data source, click Delete.
5. Confirm the settings and click OK. The deletion takes about 10 seconds.

Using a LakeFormation Data Source

For details about how to use the LakeFormation data source, see "Data Migration" > "Data Import" > "Using LakeFormation to Import Data" in GaussDB(DWS) Developer Guide.