Amazon QuickSight is cloud-powered, serverless, and embeddable enterprise intelligence (BI) service that makes it easy to ship insights to your group. As a totally managed service, Amazon QuickSight enables you to create and publish interactive dashboards that may then be accessed from completely different units and embedded into your purposes, portals, and web sites.
When authors create datasets, construct dashboards, and share with end-users, the customers will see the identical knowledge because the writer, except row-level safety (RLS) is enabled within the Amazon QuickSight dataset. Amazon QuickSight additionally supplies choices to go a reader’s id to an information supply utilizing trusted id propagation and apply RLS on the supply. To be taught extra, see Centrally handle permissions for tables and views accessed from Amazon QuickSight with trusted id propagation and Simplify entry administration with Amazon Redshift and AWS Lake Formation for customers in an Exterior Id Supplier.
Nevertheless, there are a couple of necessities when utilizing trusted id propagation with Amazon QuickSight:
- The authentication methodology for Amazon QuickSight have to be utilizing AWS IAM Id Heart.
- The dataset created utilizing trusted id propagation might be a direct question dataset in Amazon QuickSight. QuickSight SPICE can’t be used with trusted id propagation. It’s because when utilizing SPICE, knowledge is imported (replicated) and subsequently the entitlements on the supply can’t be used when readers entry the dashboard.
This put up outlines an answer to mechanically replicate the entitlements for readers from the supply (AWS Lake Formation) to Amazon QuickSight. This resolution can be utilized even when the authentication methodology in Amazon QuickSight will not be utilizing IAM Id Heart and may work with each direct question and SPICE datasets in Amazon QuickSight. This allows you to make the most of auto scaling that comes with SPICE. Though we deal with utilizing a Lake Formation desk that exists in the identical account, you’ll be able to lengthen the answer for cross-account tables as effectively. When extracting knowledge filter guidelines for the desk in one other account, the execution position will need to have vital entry to the tables within the different account.
Use case overview
For this put up, let’s contemplate a big monetary establishment that has applied Lake Formation as its central knowledge lake and entitlement administration system. The establishment goals to streamline entry management and keep a single supply of reality for knowledge permissions throughout its complete knowledge ecosystem. Through the use of Lake Formation for entitlement administration, the monetary establishment can keep a strong, scalable, and compliant knowledge entry management system that serves as the inspiration for its data-driven operations and analytics initiatives. This strategy is especially essential for sustaining compliance with monetary rules and sustaining knowledge safety. The analytics group desires to construct an Amazon QuickSight dashboard for knowledge and enterprise groups.
Resolution overview
This resolution makes use of APIs of AWS Lake Formation and Amazon QuickSight to extract, remodel, and retailer AWS Lake Formation knowledge filters in a format that can be utilized in QuickSight.
The answer has 4 key steps:
- Extract and remodel the row-level safety (knowledge filters) and permissions to knowledge filters for tables of curiosity from AWS Lake Formation.
- Create a guidelines dataset in Amazon QuickSight.
We use the next key companies:
The next diagram illustrates the answer structure.
Conditions
To implement this resolution, you must have following companies enabled in the identical account
- AWS Lake Formation and
- Amazon QuickSight
- AWS Id and Entry Administration (IAM) permissions: Be sure you have vital IAM permissions to carry out operation throughout all of the companies talked about within the resolution overview above
- AWS Lake Formation desk with knowledge filters with proper permissions
- Amazon QuickSight principals (Customers or Teams)
The under part reveals how one can create Amazon QuickSight teams and AWS Lake formation tables and knowledge filters
Create teams in QuickSight
Create two teams in Amazon QuickSight: QuickSight_Readers and QuickSight_Authors. For directions, see Create a bunch with the QuickSight console.
You possibly can then type the Amazon Useful resource Names (ARNs) of the teams as follows. These might be used when granting permission in AWS Lake Formation for knowledge filters.
arn:aws:quicksight:<
:> <
>:group/< >/QuickSight_Readers arn:aws:quicksight:<
:> <
>:group/< >/QuickSight_Authors
You may as well get the ARN of the teams by executing the Amazon QuickSight CLI command list-groups. The next screenshot reveals the output.
Create a desk in AWS Lake Formation
The next part is for instance functions and never vital for manufacturing use of this resolution. Full the next steps to create a desk in AWS Lake Formation utilizing pattern knowledge. On this put up, the desk known as saas_sales
.
- Obtain the file Saas Gross sales.csv.
- Add the file to an Amazon S3 location.
- Create a desk in AWS Lake Formation.
Create row-level safety (knowledge filter) in AWS Lake Formation
In AWS Lake Formation, knowledge filters are used to filter the info in a desk for a person or group. Full the next steps to create an information filter:
- Create an information filter known as
QuickSightReaderFilter
within the desksaas_sales
. For Row-level entry, enter the expressionphase="Enterprise"
. - Grant the Amazon QuickSight group entry to this knowledge filter. Use the reader group ARN from step one for SAML Customers and teams.
- Grant the
QuickSight_Authors
group full entry to the desk. Use the reader group ARN from step one for SAML Customers and teams. - (Elective) You possibly can create one other desk known as
second_table
and create one other knowledge filter known asSecondFilter
and grant permission to theQuickSight_Readers
group.
Now that you’ve got arrange the desk, permissions, and knowledge filters, you’ll be able to extract the row-level entry particulars for the QuickSight_Readers
and QuickSight_Authors
teams and the saas_sales
desk in AWS Lake Formation, and create the foundations dataset in Amazon QuickSight for the saas_sales
desk.
Extract and remodel knowledge filters and permissions from AWS Lake Formation utilizing a Lambda operate
In AWS Lake Formation, knowledge filters are created for every desk. There might be many tables in AWS Lake Formation. Nevertheless, for a group or a challenge, there are solely a selected set of tables that the BI developer is excited by. Due to this fact, select an inventory of tables to trace and replace the info filters for. In a batch course of, for every desk in AWS Lake Formation, extract the info filter definitions and write them into Amazon S3 utilizing AWS Lake Formation and Amazon S3 APIs.
We use the next AWS Lake Formation APIs to extract the info filter particulars and permissions:
- ListDataCellFilters – This API is used to listing all the info filters in every desk that’s required for the challenge
- ListPermissions – This API is used to retrieve the permissions for every of the info filters extracted utilizing the
ListDataCellFilters
API
The Lambda operate covers three elements of the answer:
- Extract the info filters and permissions to knowledge filters for tables of curiosity from AWS Lake Formation
- Remodel the info filters and permission right into a format usable in Amazon QuickSight
- Persist the remodeled knowledge
Full the next steps to create an AWS Lambda operate:
- On the Lambda console, create a operate known as
Lake_Formation_QuickSight_RLS
. Use Python 3.12 because the runtime and create a brand new position for execution. - Configure Lambda operate timeout to 2 minutes. This will range relying on the variety of tables to be parsed and the variety of knowledge filters to be remodeled.
- Connect the next permissions to the Lambda execution position:
- Set the next setting variables for the Lambda operate:
Identify Worth S3Bucket Worth of the S3 bucket the place the output recordsdata might be saved tablesToTrack Listing of tables to trace as JSON transformed to string Tmp /tmp
The Lambda operate will get the listing of tables and S3 bucket particulars from the setting variables. The listing of tables is given as a JSON array transformed to string. The JSON format is proven within the following code. The values for catalogId
, DatabaseName
, and Identify
might be fetched from the AWS Lake Formation console.
- Add a folder named
tmp
. - Obtain the zip file Lake_Formation_QuickSight_RLS.zip.
Notice: That is pattern code for non-production utilization. You need to work along with your safety and authorized groups to fulfill your organizational safety, regulatory, and compliance necessities earlier than deployment. - For the Lambda operate code, add the downloaded .zip file to the Lambda operate, on the Code tab.
- Present vital entry to the execution position in AWS Lake Formation. Though the AWS Id and Entry Administration (IAM) permissions are given to the Lambda execution position, express permission must be given to the position in AWS Lake Formation for the Lambda operate to get the main points concerning the knowledge filters. Due to this fact, it’s a must to explicitly grant entry to the execution position to restrict the Lambda position to read-only admin. For extra particulars, see Viewing knowledge filters.
Within the following sections, we clarify what the Lambda operate code does in additional element.
Extract knowledge filters and permissions for knowledge filters and tables in AWS Lake Formation
The primary circulation of the code takes the listing of tables as enter and extracts desk and knowledge filter permissions and knowledge filter guidelines. The strategy right here is to get the permissions for your entire desk and likewise for the info filters utilized to the desk. This fashion, each full entry (desk stage) and partial entry (knowledge filter) might be extracted.
Remodel knowledge filter definitions in to a format usable in Amazon QuickSight
The extracted permissions and filters are remodeled to create a guidelines dataset in Amazon QuickSight. There are alternative ways to outline knowledge filters. The next determine illustrates a number of the instance transformations.
The operate transformDataFilterRules
within the following code can remodel a number of the OR and AND circumstances into Amazon QuickSight acceptable format. The next are the main points obtainable within the remodeled format:
- Lake Formation catalog ID
- Lake Formation database title
- Lake Formation desk title
- Lake Formation knowledge filter title
- Listing of columns from all of the tables supplied within the enter for which the info filter guidelines are outlined
See the next code:
The next determine is an instance of the remodeled file. The file incorporates the columns for each tables. When making a guidelines dataset for a selected desk, the data are filtered for that desk pulled into Amazon QuickSight.
The operate transformFilterandTablePermissions
within the following code snippet combines and transforms the desk and knowledge filter permissions right into a flat construction that incorporates the next columns:
- Amazon QuickSight group ARN
- Lake Formation catalog ID
- Lake Formation database title
- Lake Formation desk title
- Lake Formation knowledge filter title
See the next code:
The next determine is an instance of the extracted knowledge filter and desk permissions. AWS Lake Formation can have knowledge filters utilized to any principal. Nevertheless, we deal with the Amazon QuickSight principals:
- The
QuickSight_Authors
ARN has full entry to 2 tables. That is decided by reworking the table-level permissions along with the info filter permissions. - The
QuickSight_Readers
ARN has restricted entry based mostly on filter circumstances.
Retailer the remodeled guidelines and permissions in two separate recordsdata in Amazon S3
The remodeled guidelines and permissions are then persevered in an information retailer. On this resolution, the remodeled guidelines are written to an Amazon S3 location in CSV format. The title of the recordsdata created by the Lambda operate are:
transformed_filter_permissions.csv
transformed_filter_rules.csv
See the next code:
Create a guidelines dataset in Amazon QuickSight
On this part, we stroll via the steps to create a guidelines dataset in Amazon QuickSight.
Create a desk in Lake formation for the recordsdata
Step one is to create a desk in AWS Lake Formation for the 2 recordsdata, transformed_filter_permissions.csv
and transformed_filter_rules.csv
.
Though you’ll be able to instantly use an Amazon S3 connector in Amazon QuickSight, making a desk and making the foundations dataset utilizing an Athena connector provides flexibility in writing customized SQL and utilizing direct question. For the steps to deliver an Amazon S3 location into AWS Lake Formation, see Creating tables.
For this put up, the tables for the recordsdata are created in a separate database known as quicksight_lf_transformation.
Grant permission for the tables to the QuickSight_Authors group
Grant permission in AWS Lake Formation for the 2 tables to the QuickSight_Authors group. That is important for Amazon QuickSight authors to create a guidelines dataset in Amazon QuickSight. The next screenshot reveals the permission particulars.
Create a guidelines dataset in Amazon QuickSight
Amazon QuickSight helps each user-level and group-level RLS. On this put up, we use teams to allow RLS. To create the foundations dataset, you first be a part of the filter permissions desk with the filter guidelines desk on the columns catalog
, database
, desk
, and filter
. Then you’ll be able to filter the permissions to incorporate the Amazon QuickSight principals, and embody solely the columns required for the dataset. The target on this resolution is to construct a guidelines dataset for the saas_sales
desk.
Full the next steps:
- On the Amazon QuickSight console, create a brand new Athena dataset.
- Specify the next:
- For Catalog, select
AWSDataCatalog
. - For Database, select
quicksight_lf_transformation
. - For Desk, select
filter_permissions
.
- For Catalog, select
- Select Edit/Preview knowledge.
- Select Add knowledge.
- Select Add supply.
- Choose Athena.
- Specify the next:
- For Catalog, select
AWSDataCatalog
. - For Database, select
quicksight_lf_transformation
. - For Desk, select
filter_rules
.
- For Catalog, select
- Be a part of the permissions desk with the info filter guidelines desk on the
catalog
,database
,desk
andfilter
columns. - Rename the column group as
GroupArn
. This must be achieved earlier than filter is utilized. - Filter the info the place column desk equals
saas_sales
. - Filter the info the place column group can also be filtered for values beginning with
arn:aws:quicksight
(Amazon QuickSight principals). - Exclude fields that aren’t a part of the
saas_sales
desk. - Change Question mode to SPICE.
- Publish the dataset.
In case your group has a mapping of different principals to a Amazon QuickSight group or consumer, you’ll be able to apply that mapping earlier than becoming a member of the tables.
You may as well write the next customized SQL to attain the identical outcome:
- Identify the dataset
LakeFormationRLSDataSet
and publish the dataset.
Check the row-level safety
Now you’re prepared to check the row-level safety by publishing a dashboard as a consumer within the QuickSight_Authors
group after which viewing the dashboard as a consumer within the QuickSight_Readers
group.
Publish a dashboard as a QuickSight_Authors group consumer
As an writer who belongs to the QuickSight_Authors
group, the consumer will have the ability to see the saas_sales
desk within the Athena connector and all the info within the desk. As proven on this part, all three segments are seen for the writer when creating an evaluation and viewing the printed dashboard.
- Create a dataset by pulling knowledge from the
saas_sales
desk utilizing the Athena connector. - Connect
LakeFormationRLSDataSet
because the RLS dataset for thesaas_sales
dataset. For directions, see Utilizing row-level safety with user-based guidelines to limit entry to a dataset. - Create an evaluation utilizing the
saas_sales
dataset as an writer who belongs to theQuickSight_Authors
group. - Publish the dashboard.
- Share the dashboard with the group
QuickSight_Readers
.
View the dashboard as a QuickSight_Readers group consumer
Full the next steps to view the dashboard as a QuickSight_Readers
group consumer:
- Log into Amazon QuickSight as a reader who belongs to the
QuickSight_Readers
group.
The consumer will have the ability to see solely the phase Enterprise.
- Now, change the RLS in AWS Lake Formation, and set the phase to be
SMB
for the QuickSightReaderFilter. - Run the Lambda operate to export and remodel the brand new knowledge filter guidelines.
- Refresh the SPICE dataset LakeFormationRLSDataSet in Amazon QuickSight.
- When the refresh is full, refresh the dashboard within the reader login.
Now the reader consumer will see SMB knowledge.
Cleanup
Amazon QuickSight assets
- Delete the Amazon QuickSight dashboard and evaluation created
- Delete the datasets
saas_sales
andLakeFormationRulesDataSet
- Delete the Athena knowledge supply
- Delete the QuickSight teams utilizing the DeleteGroup API
AWS Lake Formation assets
- Delete the database
quicksight_lf
transformation created in AWS Lake Formation - Revoke permission given to the Lambda execution position
- Delete the
saas_sales
desk and knowledge filters created - When you have used Glue crawler to create the tables in AWS Lake Formation, take away the Glue crawler as effectively
Compute assets
- Delete the AWS Lambda operate created
- Delete the AWS Lambda execution position related to the lambda
Storage assets
- Empty the content material of the Amazon S3 bucket created for this resolution
- Delete the Amazon S3 bucket
Conclusion
This put up defined replicate row-level safety in AWS Lake Formation mechanically in Amazon QuickSight. This makes positive that the SPICE dataset in QuickSight can use row-level entry outlined in Lake Formation.
This resolution can be prolonged for different knowledge sources. The logic to programmatically extract the entitlements from the supply and remodel them into Amazon QuickSight format will range by supply. After the extract and remodel are in place, it may possibly scale to a number of groups within the group. Though this put up laid out a fundamental strategy, the automation must be both scheduled to run periodically or triggered based mostly on occasions like knowledge filters change or grant or revoke of AWS Lake Formation permissions to ensure that the entitlements stay in sync between AWS Lake Formation and Amazon QuickSight.
Check out this resolution in your personal use case, and share your suggestions within the feedback.
Concerning the Authors
Vetri Natarajan is a Specialist Options Architect for Amazon QuickSight. Vetri has 15 years of expertise implementing enterprise enterprise intelligence (BI) options and greenfield knowledge merchandise. Vetri makes a speciality of integration of BI options with enterprise purposes and allow data-driven selections.
Ismael Murillo is a Options Architect for Amazon QuickSight. Earlier than becoming a member of AWS, Ismael labored in Amazon Logistics (AMZL) with supply station administration, supply service suppliers, and our buyer actively within the area. Ismael targeted on final mile supply and supply success. He designed and applied many revolutionary options to assist cut back value, affect supply success. He’s additionally a United States Military Veteran, the place he served for eleven years.