Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

After following the deployment instructions , the user can call the dbo.QueueExport proc to queue the tables to be exported. Upon execution, the proc will insert a pointer for all the active exports at that time into the PTG_ExportQueue table, where the records will await for the next time the job runs, exports the rows and marks the rows as exported in the PTG_ExportOut table.

User Guide
Anchor
User-Guide
User-Guide

Here’s the following steps on using this tool. (Missing reference images)

  1. Ensure the Export Job has been deployed and scheduled.

  2. Ensure the Export Queues are set up and enabled.

  3. Populate and configure your Benchmark tables

  4. Run ‘Exec dbo.QueueExport’

  5. Wait for the job to pick up the queues and create the files.

How to set up
Anchor
How-to-set-up
How-to-set-up

You’ll need to create an export queue for the exporter job to pick up the tables you want to export. You may use the Insert script on TFS as a starting point to write all the table’s export queues.

...

  1. Deploy the solution tables to the DB.

  2. Populate the PTG_ExportDeploy and PTG_ExportConfig tables with the table names, file names, file paths and active flag.

    1. Check that the server has access to the destination File path.

  3. Deploy the queuing procedure (dbo.QueueExport).

  4. Deploy the package as a scheduled SQL Agent Job, running every 15 or 30 mins.

Troubleshooting

  • Error "ACE.OLEDB.12.0 Provider Not Registered on local machine"

If you receive the error above, you need to ensure the host machine has the drivers installed. See Microsoft’s Guide: ACE.OLEDB.12.0 provider not registered on local machine | Microsoft Docs

These drivers are on the TFS: \TFS\Conversion\Integration_Pipeline\Export Job\Troubleshooting\

64-bit and 32-bit, Depending on which version of Office is installed on the host machine. If after installation of one, the error persists, please uninstall and install the other one.

  • Error “Cannot reach the [export] location”

For the current iteration of the Exporter, we have not added support to create the File location directory, so we need to ensure the folder exists prior to execution.

Checking if the Server can see the File Path

We can use the following commands to check if the SQL Server can access the file location we want to set as the export location.

...

SQL Server Deployment mismatch

The Script Task "XXX" uses version XX.0 script that is not supported in this release of Integration Services. This error is due to the script deployment targeting a later SQL Server version than the current one. i.e. Script deployment looking for SQL Server 2022, but the server is 2019.

...

To fix, we’ll need to update the Project deployment settings on the package to match the target SQL Server version.

Right click the Project > Properties > Configuration Properties > General > TargetServerVersion > Select version from dropdown.

...

From here we can save our package and if working locally, manually deploy it to our customer’s Server, or if working on the customer environment, deploy it directly from Visual Studio.

...