Biml Academy 2 - Lesson 5: Importing source metadata into Biml
3 likes8,567 views
The document outlines lessons in a Biml Academy course focusing on importing, staging, and loading data using Biml. Key topics include methods for importing metadata, such as 'importtablenodes' and 'getdatabaseschema', along with various import options and parameters. Additional lessons cover staging data, metadata-driven patterns, and using Biml for data vault data warehouses.
Biml Academy 2 - Lesson 5: Importing source metadata into Biml
- 1. Biml Academy 2 Importing, Staging, and Loading Data with Biml Andy Leonard · Scott Currie · Cathrine Wilhelmsen
- 2. Biml Academy 2 Lesson 5: Importing source metadata into Biml (Cathrine) Lesson 6: Staging data with Biml (Andy) Lesson 7: Metadata-driven staging pattern with Biml (Andy) Lesson 8: BimlFlex for Data Vault data warehouses (Scott) Lesson 9: Biml Q&A with several BimlHeroes!
- 3. Cathrine Wilhelmsen @cathrinew cathrinew.net Data Warehouse Architect Business Intelligence Developer
- 4. Lesson 5: Importing source metadata into Biml
- 5. Methods for importing metadata ImportTableNodes ImportDB GetDatabaseSchema
- 6. Methods for importing metadata ImportTableNodes Import tables and views in one schema Filter tables using LIKE % wildcard syntax
- 7. Methods for importing metadata ImportDB Import all schemas, tables and views Filter using LIKE % wildcard syntax
- 8. Methods for importing metadata GetDatabaseSchema Import all schemas, tables and views Filter using collections
- 9. Why ImportDB and GetDatabaseSchema? ImportDB / ImportTableNodes • SELECT * on each imported table • SELECT to get defaults, indexes etc. • Using SchemaOnly mode • Doesn't actually run the query, but returns schema for the result set GetDatabaseSchema • Figures out target database type (SQL Server, Oracle, Teradata, DB2, PostgreSQL, Ingres, OpenEdge etc.) • Queries the relevant information schema for that database type A few queries for the entire importMultiple queries per table
- 10. But why keep both if one is faster? Support for legacy scripts :) They can return different results – where both are valid/correct Different data type mapping defaults in different systems (Bulk Copy, SSIS and Excel are all different) Biml supports the two most commonly used approaches
- 11. Methods and parameters ImportTableNodes(schema, tableFilter) ImportTableNodes(schema, tableFilter, importOptions) ImportDB() ImportDB(schemaFilter, tableFilter) ImportDB(schemaFilter, tableFilter, importOptions) GetDatabaseSchema() GetDatabaseSchema(importOptions) GetDatabaseSchema(includedSchemas, includedTables, importOptions)
- 12. Methods and parameters: string value ImportTableNodes(schema, tableFilter) ImportTableNodes(schema, tableFilter, importOptions) ImportDB() ImportDB(schemaFilter, tableFilter) ImportDB(schemaFilter, tableFilter, importOptions) GetDatabaseSchema() GetDatabaseSchema(importOptions) GetDatabaseSchema(includedSchemas, includedTables, importOptions)
- 13. Methods and parameters: string filter ImportTableNodes(schema, tableFilter) ImportTableNodes(schema, tableFilter, importOptions) ImportDB() ImportDB(schemaFilter, tableFilter) ImportDB(schemaFilter, tableFilter, importOptions) GetDatabaseSchema() GetDatabaseSchema(importOptions) GetDatabaseSchema(includedSchemas, includedTables, importOptions)
- 14. Methods and parameters: collections ImportTableNodes(schema, tableFilter) ImportTableNodes(schema, tableFilter, importOptions) ImportDB() ImportDB(schemaFilter, tableFilter) ImportDB(schemaFilter, tableFilter, importOptions) GetDatabaseSchema() GetDatabaseSchema(importOptions) GetDatabaseSchema(includedSchemas, includedTables, importOptions)
- 15. Methods and parameters: ImportOptions ImportTableNodes(schema, tableFilter) ImportTableNodes(schema, tableFilter, importOptions) ImportDB() ImportDB(schemaFilter, tableFilter) ImportDB(schemaFilter, tableFilter, importOptions) GetDatabaseSchema() GetDatabaseSchema(importOptions) GetDatabaseSchema(includedSchemas, includedTables, importOptions)
- 16. ImportOptions specify objects to exclude Don't exclude anything Views Identity Specifications Primary Keys Foreign Keys Unique Keys Indexes Column Defaults Check Constraints ImportOptions.None ImportOptions.ExcludeViews ImportOptions.ExcludeIdentity ImportOptions.ExcludePrimaryKey ImportOptions.ExcludeForeignKey ImportOptions.ExcludeUniqueKey ImportOptions.ExcludeIndex ImportOptions.ExcludeColumnDefault ImportOptions.ExcludeCheckConstraint
- 17. Demo time!
- 18. Additional methods for importing metadata GenerateSchemaNode Returns AstSchemaNode GenerateSchemaNodes Returns IEnumerable<AstSchemaNode>
- 19. Additional methods for importing metadata GenerateTableNode Returns AstTableNode GenerateTableNodes Returns IEnumerable<AstTableNode>
- 20. Demo time!
- 21. Biml Academy 2 Lesson 5: Importing source metadata into Biml (Cathrine) Lesson 6: Staging data with Biml (Andy) Lesson 7: Metadata-driven staging pattern with Biml (Andy) Lesson 8: BimlFlex for delivering Data Vault data warehouses (Scott) Lesson 9: Biml Q&A with several BimlHeroes!