Microsoft Fabric Stage JDBC - Replace the placeholders - 1.6

The Generated Artifacts zip file contains files with placeholders for the target environment parameters.

You should replace all the placeholders to deploy to Microsoft Fabric Target System.

Replace the Placeholders

A toolkit is provided in the generated artifacts to replace the placeholders.

It is composed of a Powershell script to execute: replace_placeholders.ps1.

To execute commands with Powershell later in this article, please use at least version 7 provided by Microsoft. If you would like to install the latest version, please check here.


The process to follow is:

  • Update the replacement_config.json file with your values:
    • Insert the value to replace into the value node
  • Each database_name is filled by default with the layer name (example: rawvault)
    • It should contain the database name of the target lakehouse
      • In our example, we want to create the target tables in the lakehouse bglakehouse1
  • Each database_directory placeholder must be empty, it is not needed for Microsoft Fabric
  • JDBC source : please put the values to access the JDBC source data:
    • jdbc_url:
      • In our SQL Server JDBC source example: jdbc:sqlserver://bgsqlserver.database.windows.net:1433;encrypt=true;databaseName={DatabaseName};trustServerCertificate=true;
      • Replace {DatabaseName} by your SQL Server database name
    • jdbc_driver:
      • In our SQL Server JDBC source example: com.microsoft.sqlserver.jdbc.SQLServerDriver
    • jdbc_user
      • In our SQL Server JDBC source example: '{DatabaseUser}'
      • Replace {DatabaseUser} by your SQL Server user
    • jdbc_password
      • In our SQL Server JDBC source example: '{DatabasePassword}'
      • Replace {DatabasePassword} by your SQL Server password

     

    All the paths should have a slash appended at the end: abfss://bgfabricworkspace1@onelake.dfs.fabric.microsoft.com/bglakehouse1.Lakehouse/Files/Parquet/

     

    Depending on your load control environment:

    • If you plan to use a native loaded control using multi-threading load, please update the execution_dependencies_file_path placeholder with the path that contains the dependencies file
      • In our example, it is abfss://bgfabricjdbc@onelake.dfs.fabric.microsoft.com/bglakehousejdbc.Lakehouse/Files/Dependencies/

     

    Replace the placeholders in the files:

    • Open Windows Powershell (or equivalent) in the replace_placeholders.ps1 location:
    • Execute the following command :
    • .\replace_placeholders.ps1
      • You should have a similar result:
    • The configured values in all generated artifacts replaced the placeholders
    • You can now use these files and deploy your Target system

    Some parameters can be added to the replace_placeholders.ps1 command.

    All are described and available by executing:

    .\replace_placeholders.ps1 - help

    The -ReplacementConfigPath parameter mainly permits using a replacement_config.json file in another path. It is beneficial when you are in a development mode for your project.

    Example of usage:

    .\replace_placeholders.ps1 -ReplacementConfigPath "C:\TEMP\Replacement config files\replacement_config_

    If you run into any issues, please refer to our FAQs section about Generating Artifacts: