Page Comparison

Table of Contents

Overview

...

...

Anchor
stage1 stage1

Stage 1 - Import and parse reference dataset (Optional)

This optional stage is run once per Bulk Loader process. This stage can be skipped if the reference dataset is already available or if the optional 'filter by reference' step is skipped.

...

Anchor
stage3 stage3

Stage 3 - Geocode and filter

•  

  Step 3.1 - Geocode source dataset

...

Anchor
stage4 stage4

Stage 4 - Export full set (single batch) or subset (multiple batches)

...

Anchor
stage5 stage5

Stage 5 - Run the Bulk Loader

...

...

 For a complete set of steps and background about the Bulk Loader, see also Running the Bulk Loader, a page dedicated to its input, operation and results.

•  

  Step 5.1 - Bulk Loader Preparation

1. Transfer the bulkload.shp shapefile from previous step to an EAS automation machine, <environment>_AUTO.

   • Substitute <environment> with one of the relevant environments: SF_DEV, SF_QA, SF_PROD, SD_PROD.

2. Copy the shapefile to the folder C:\apps\eas_automation\app_data\data\bulkload_shapefile.

3. Connect to the database, <environment>_DB, and clear any leftover records from previous Bulk Loader batches.

   1. TRUNCATE bulkloader.address_extract, bulkloader.blocks_nearest;

   2. VACUUM FULL ANALYZE bulkloader.address_extract;

   3. VACUUM FULL ANALYZE bulkloader.blocks_nearest;

4. Make note of EAS record counts before the Bulk Loading operation.

   
   

   Code Block
   language sql firstline 1 title Record Counts linenumbers true
   SELECT schemaname,relname,n_live_tup FROM pg_stat_user_tables ORDER BY schemaname,relname,n_live_tup

   
   

•  

  Step 5.2 - Halt Services (production only)

  1. Place EAS web application into maintenance mode

     • See also Web Application into Maintenance Mode

  2. Turn off the replication server

     • See also Replication Setup

  3. Turn off downstream database propagation service(s)

  
  

•  

  Step 5.3 - Backup Database

1. Make a backup of the EAS database
   • See also Backup the EAS Databases

•  

  Step 5.4 - Run Bulk Loader

1. Open a command prompt and change folders:

   • cd C:\apps\eas_automation\automation\src

2. Run the step to stage the address records:

   • python job.py --job stage_bulkload_shapefile --env SF_DEV --action EXECUTE --v

3. Run the step to bulk load the address records:

   • python job.py --job bulkload --env SF_DEV --action EXECUTE --v

4.  To calculate the time it took to run the Bulk Loader look at the timestamps in the output or use a stopwatch or clock to time the operation.

   
   

•  

  Step 5.3 - 

  Anchor
  analysis analysis

  Analysis

1. Query and make note of totals in the bulkloader.address_extract table. The results here will be used to cross check the results in the next stage.

   1. Count/view new base addresses added to the EAS.

      
      

      Code Block
      language sql firstline 1 title Count/view new base addresses linenumbers true
      SELECT COUNT(*) FROM bulkloader.address_extract WHERE NOT (street_segment_id IS NULL) SELECT * FROM bulkloader.address_extract WHERE NOT (street_segment_id IS NULL)

      
      

   2. Count/view unit addresses (some were already there, some are new)

      Code Block
      language sql firstline 1 title Count/view unit addresses linenumbers true
      SELECT COUNT(*) FROM bulkloader.address_extract WHERE NOT (address_id IS NULL) SELECT * FROM bulkloader.address_extract WHERE NOT (address_id IS NULL)

      
      

2. Make note of EAS record counts after the Bulk Load operation.

   
   

   Code Block
   language sql firstline 1 title Record Counts linenumbers true
   SELECT schemaname,relname,n_live_tup FROM pg_stat_user_tables ORDER BY schemaname,relname,n_live_tup

   
   

   • A comparison of 'before' and 'after' record counts will indicate the number of new base addresses added to the table `public.address_base` and the number of new addresses and units added to the table `public.addresses`.

   1.  See dedicated Bulk Loader page, Running the Bulk Loader, for more analysis options.
      
      

Anchor
stage6 stage6

Stage 6 - Extract results

•  

  Step 6.1 - Archive exceptions

...