New Blueprint appears only when you have blueprint management access. Ask an administrator to
review Manage blueprints under Lakehouse in your role.
Before you begin
Prepare:- a unique blueprint name;
- a concise description of the entity’s purpose and grain;
- validated SQL that uses catalog entities available to your role;
- descriptions and sensitivity classifications for important output columns;
- tags that help other people find the entity.
Create the blueprint
1
Open the form
Go to Documentation > Catalog, then select New Blueprint.
2
Add documentation
Enter Blueprint name, Description, and Tags. The name must be valid and unique.
3
Write the SQL
Build the query in the SQL editor. Search the Source explorer and select an entity or column to insert it into the editor.
4
Validate the output
Run the SQL. DataX validates the query and fills the Columns and Results tabs.
5
Document columns
Review inferred data types, add column descriptions, and apply available masking classifications where appropriate.
6
Review role access
If you can manage data access, use Role Access to choose which roles can query the new entity.
7
Save or publish
Select Save Draft to save the definition without deploying it, or Publish & Deploy to make the validated version live.
Write maintainable SQL
- Select only the columns the entity needs.
- Give calculated columns clear, stable names.
- Make joins explicit and verify their effect on row counts.
- Avoid depending on an entity that is disabled or scheduled for replacement.
- Use the editor’s format action before review.