Skip to main content

Well headers

Well headers


1. Integration overview

Dataset Name: Well Headers
Secure View: WELL_HEADERS_SV
Delivery Mechanism: Snowflake Secure View via Private Share
Update Pattern: Continuous Update
Export Trigger: None — this dataset is delivered continuously via the Apache Beam CDC pipeline, not on export.


2. Business context (Oil & Gas Reservoir Engineering)

The Well Headers dataset provides the core well master/header record along with operational, geologic, completion, production summary, and economic attributes for each well.
It contains Well Header fields and is exposed via a secure view that performs a direct pass-through (SELECT *) from the base table.


3. Dataset characteristics

What this dataset is

  • Entity grain: One record per well (latest version).

Mutable, near real-time dataset

This dataset is mutable: records may be inserted, updated, or soft-deleted after their initial arrival.

Updates are delivered to Snowflake via an Apache Beam pipeline fed by MongoDB change data capture (CDC) from ComboCurve Main. When a change is made in ComboCurve Main, the corresponding change is typically reflected in Snowflake within ~1–3 minutes.

Soft deletes

When a record is deleted in the source system (or suppressed for integration purposes), the dataset reflects that through the __SOFT_DELETE flag. Clients should filter __SOFT_DELETE = FALSE unless they explicitly want to track deletions.


4. Expected record uniqueness

  • Technical uniqueness (as exposed by the secure view): ID
  • Business identity (recommended for client reporting): CHOSEN_ID + DATASOURCE + PROJECT_NAME

5. Client access pattern

Query the secure view directly:

  • Primary access object: WELL_HEADERS_SV
  • Typical filters:
    • __SOFT_DELETE = FALSE (exclude logically deleted records)
    • ID (for a specific well)
    • CHOSEN_ID + DATASOURCE + PROJECT_NAME (for a specific well)

Example:

SELECT *
FROM WELL_HEADERS_SV
WHERE __SOFT_DELETE = FALSE;

6. Full schema definition (client-facing secure view)

Below is the client-facing schema for WELL_HEADERS_SV, grouped into practical data categories for easier review.

6.1 Core identifiers

ColumnData TypeDescription
IDVARCHARUnique identifier for the well header
API10VARCHAR10-digit API well number (US).
API12VARCHAR12-digit API well number (US).
API14VARCHAR14-digit API number uniquely identifying the wellbore.
ARIES_IDVARCHARWell identifier in ARIES economic software.
CHOSEN_IDVARCHARChosen ID
CHOSEN_KEY_IDVARCHARChosen ID Key (what other ID is being used as Chosen ID)
COPIED_WELLBOOLEANDenotes if a well was created as a copy
COPIED_FROMVARCHARCopied from ID (i.e. what well was copied to create this well)
DATAPOOLVARCHARData pool
DATASOURCEVARCHARData source (IHS, DI, etc)
DATASOURCE_CUSTOM_NAMEVARCHARThe datasource custom name of the well header.
DRILLINGINFO_IDVARCHARDrilling info ID
GENERICBOOLEANDenotes if a well was created within ComboCurve
IHS_IDVARCHARIHS ID
INPT_IDVARCHARComboCurve assigned unique well identifier
LEASE_NAMEVARCHARLease name
LEASE_NUMBERVARCHARLease number
PAD_NAMEVARCHARPad name
PHDWIN_IDVARCHARPHDWin ID
PROJECT_IDVARCHARProject ID
SCOPEVARCHARData scope (project or company)
TYPE_CURVE_AREAVARCHARType curve area
WELL_NAMEVARCHARWell name
WELL_NUMBERVARCHARWell number
WELL_TYPEVARCHARWell type
PROJECT_NAMEVARCHARName of the associated project

6.2 Geography and location

ColumnData TypeDescription
AZIMUTHFLOATAzimuth
BASINVARCHARBasin
BLOCKVARCHARBlock
COUNTRYVARCHARCountry
COUNTYVARCHARCounty
DISTRICTVARCHARDistrict
ELEVATIONFLOATElevation (FT)
ELEVATION_TYPEVARCHARElevation type
FIELDVARCHARField
GROUND_ELEVATIONFLOATGround elevation (FT)
HEEL_LATITUDEFLOATHeel latitude
HEEL_LONGITUDEFLOATHeel longitude
HOLE_DIRECTIONVARCHARHole Direction
PLAYVARCHARPlay
RANGEVARCHARRange
SECTIONVARCHARSection
STATEVARCHARState
SUBPLAYVARCHARSubplay
SURFACE_LATITUDEFLOATSurface latitude
SURFACE_LONGITUDEFLOATSurface longitude
SURVEYVARCHARSurvey
TOE_LATITUDEFLOATToe latitude
TOE_LONGITUDEFLOATToe longitude
TOWNSHIPVARCHARTownship

6.3 Reservoir and fluids

ColumnData TypeDescription
BUBBLE_POINT_PRESSFLOATBubble point pressure (PSI)
FLUID_TYPEVARCHARFluid type
FORMATION_THICKNESS_MEANFLOATFormation thickness mean (FT)
GAS_SPECIFIC_GRAVITYFLOATGas specific gravity
INITIAL_RESPRESSFLOATInitial reservoir pressure in (PSI)
INITIAL_RESTEMPFLOATInitial reservoir temperature in (F)
LANDING_ZONEVARCHARLanding Zone
LANDING_ZONE_BASEFLOATBase landing zone (FT)
LANDING_ZONE_TOPFLOATTop landing zone (FT)
MATRIX_PERMEABILITYFLOATMatrix permeability (nD)
OIL_API_GRAVITYFLOATOil API gravity
OIL_SPECIFIC_GRAVITYFLOATOil specific gravity
POROSITYFLOATPorosity
SGFLOATGas specific gravity
SOFLOATOil specific gravity
SWFLOATWater saturation
TARGET_FORMATIONVARCHARTarget formation
THICKNESSFLOATThickness (FT)

6.4 Wellbore and geometry

ColumnData TypeDescription
CASING_IDFLOATCasing inner diameter (IN)
DISTANCE_FROM_BASE_OF_ZONEFLOATDistance from base of zone (FT)
DISTANCE_FROM_TOP_OF_ZONEFLOATDistance from top of zone (FT)
FLOW_PATHVARCHARFlow path
FOOTAGE_IN_LANDING_ZONEFLOATFootage in landing zone (FT)
LATERAL_LENGTHFLOATLateral length (FT)
LOWER_PERFORATIONFLOATLower perforation (FT)
MEASURED_DEPTHFLOATMeasured depth (FT)
PERCENT_IN_ZONEFLOATPercent in zone (%)
PERF_LATERAL_LENGTHFLOATPerforated lateral length (FT)
TOE_IN_LANDING_ZONEVARCHARToe in landing zone
TOE_UPVARCHARToe up
TRUE_VERTICAL_DEPTHFLOATTrue vertical depth (FT)
TUBING_DEPTHFLOATTubing depth (FT)
TUBING_IDFLOATTubing ID
UPPER_PERFORATIONFLOATUpper perforation (FT)

6.5 Key dates

ColumnData TypeDescription
COMPLETION_END_DATEDATECompletion end date
COMPLETION_START_DATEDATECompletion start date
CREATED_ATTIMESTAMP_NTZ(9)Well created at timestamp
DATE_RIG_RELEASEDATERig release date
DRILL_END_DATEDATEDrill end date
DRILL_START_DATEDATEDrill start date
ECON_FIRST_PRODUCTION_DATEDATEApplied first production date from economic run
ECON_RUN_DATEDATEApplied date at which economics was ran
FIRST_PROD_DATEDATEFirst production date
FIRST_PROD_DATE_DAILY_CALCDATEDaily first production date (calculated from daily prod data)
FIRST_PROD_DATE_MONTHLY_CALCDATEMonthly first production date (calculated from monthly prod data)
LAST_PROD_DATE_DAILYDATEDaily last production date (calculated from daily production data)
LAST_PROD_DATE_MONTHLYDATEMonthly last production date (calculated from monthly production data)
MOST_RECENT_IMPORT_DATEDATEMost recent import date
PERMIT_DATEDATEPermit date
REFRAC_DATEDATERefrac date
SPUD_DATEDATESpud date
UPDATED_ATTIMESTAMP_NTZ(9)Updated at timestamp

6.6 Operator

ColumnData TypeDescription
CURRENT_OPERATORVARCHARCurrent operator
CURRENT_OPERATOR_ALIASVARCHARCurrent operator alias
CURRENT_OPERATOR_CODEVARCHARCurrent operator code
CURRENT_OPERATOR_TICKERVARCHARCurrent operator ticker
PREVIOUS_OPERATORVARCHARPrevious operator
PREVIOUS_OPERATOR_ALIASVARCHARPrevious operator alias
PREVIOUS_OPERATOR_CODEVARCHARPrevious operator code
PREVIOUS_OPERATOR_TICKERVARCHARPrevious operator ticker

6.7 Spacing and relationships

ColumnData TypeDescription
ACRE_SPACINGFLOATAcre same zone spacing (ACRE)
HZ_WELL_SPACING_ANY_ZONEFLOATHorizontal well spacing in any zone (FT)
HZ_WELL_SPACING_SAME_ZONEFLOATHorizontal well spacing in same zone (FT)
PARENT_CHILD_ANY_ZONEVARCHARParent child any zone (references a well identifier)
PARENT_CHILD_SAME_ZONEVARCHARParent child same zone (references a well identifier)
VT_WELL_SPACING_ANY_ZONEFLOATVertical well spacing any zone (FT)
VT_WELL_SPACING_SAME_ZONEFLOATVertical well spacing same zone (FT)

6.8 Completion and treatment

ColumnData TypeDescription
CHOKE_SIZEFLOATChoke size (IN)
COMPLETION_DESIGNVARCHARCompletion design
FIRST_ADDITIVE_VOLUMEFLOATAdditive volume from first job (GAL)
FIRST_CLUSTER_COUNTFLOATCluster count from first job
FIRST_DISCOUNT_CASH_FLOWFLOATFirst discount cash flow applied to header after econ run (M$)
FIRST_FLUID_PER_PERFORATED_INTERVALFLOATFluid volume from first job per foot of PLL (GAL/FT)
FIRST_FLUID_VOLUMEFLOATFluid volume from first job (GAL)
FIRST_FRAC_VENDORVARCHARFirst job frac vendor
FIRST_MAX_INJECTION_PRESSUREFLOATMax injection pressure from first job (PSI)
FIRST_MAX_INJECTION_RATEFLOATMax injection rate from first job (BBL/MIN)
FIRST_PROP_WEIGHTFLOATProppant weight from first job (LB)
FIRST_PROPPANT_PER_FLUIDFLOATProppant weight from first job per gallon of fluid (LB/GAL)
FIRST_PROPPANT_PER_PERFORATED_INTERVALFLOATProppant weight from first job per foot of PLL (LB/FT)
FIRST_STAGE_COUNTFLOATFirst job stage count
FIRST_TEST_FLOW_TBG_PRESSFLOATFirst test flow tubing pressure (PSI)
FIRST_TEST_GAS_VOLFLOATFirst test gas volume (MCF)
FIRST_TEST_GORFLOATFirst test GOR (CF/BBL)
FIRST_TEST_OIL_VOLFLOATFirst test oil volume (BBL)
FIRST_TEST_WATER_VOLFLOATFirst test water volume (BBL)
FIRST_TREATMENT_TYPEVARCHARFirst job treatment type
NUM_TREATMENT_RECORDSFLOATNumber of treatment records
PRIMARY_PRODUCTVARCHARPrimary product
PRODUCTION_METHODVARCHARProduction method
PROPPANT_MESH_SIZEVARCHARProppant mesh size
PROPPANT_TYPEVARCHARProppant type
RECOVERY_METHODVARCHARRecovery method
REFRAC_ADDITIVE_VOLUMEFLOATRefrac additive volume (GAL)
REFRAC_CLUSTER_COUNTFLOATRefrac cluster count
REFRAC_FLUID_PER_PERFORATED_INTERVALFLOATRefrac fluid per foot of PLL (BBL/FT)
REFRAC_FLUID_VOLUMEFLOATRefrac fluid volume (BBL)
REFRAC_FRAC_VENDORVARCHARRefrac frac vendor
REFRAC_MAX_INJECTION_PRESSUREFLOATRefrac max injection pressure (PSI)
REFRAC_MAX_INJECTION_RATEFLOATRefrac max injection rate (BBL/MIN)
REFRAC_PROP_WEIGHTFLOATRefrac proppant weight (LB)
REFRAC_PROPPANT_PER_FLUIDFLOATRefrac proppant per gallon of fluid (LB/GAL)
REFRAC_PROPPANT_PER_PERFORATED_INTERVALFLOATRefrac proppant per foot of PLL (LB/FT)
REFRAC_STAGE_COUNTFLOATRefrac stage count
REFRAC_TREATMENT_TYPEVARCHARRefrac treatment type
STAGE_SPACINGFLOATStage spacing (FT)
TOTAL_ADDITIVE_VOLUMEFLOATAdditive volume from all jobs (GAL)
TOTAL_CLUSTER_COUNTFLOATCluster count from all jobs
TOTAL_FLUID_PER_PERFORATED_INTERVALFLOATFluid volume from all jobs per foot of PLL (BBL/FT)
TOTAL_FLUID_VOLUMEFLOATFluid volume from all jobs (BBL)
TOTAL_PROP_WEIGHTFLOATProppant from all jobs (LBS)
TOTAL_PROPPANT_PER_FLUIDFLOATProppant from all jobs per gallon of fluid (LB/GAL)
TOTAL_PROPPANT_PER_PERFORATED_INTERVALFLOATProppant from all jobs per foot of PLL (LB/FT)
TOTAL_STAGE_COUNTFLOATStage count from all jobs

6.9 Production metrics and flags

ColumnData TypeDescription
CUM_BOEFLOATCalculated cumulative BOE production (MBOE)
CUM_BOE_PER_PERFORATED_INTERVALFLOATCalculated cumulative BOE per foot of PLL (BOE/FT)
CUM_GASFLOATCalculated cumulative gas production (MMCF)
CUM_GAS_PER_PERFORATED_INTERVALFLOATCalculated cumulative gas production per foot of PLL (MCF/FT)
CUM_GORFLOATCalculated cumulative GOR production (CF/BBL)
CUM_MMCFGEFLOATCalculated cumulative MMCFGE production (MMCFE)
CUM_MMCFGE_PER_PERFORATED_INTERVALFLOATCalculated cumulative MMCFGE production per foot of PLL (MCFE/FT)
CUM_OILFLOATCalculated cumulative oil production (MBBL)
CUM_OIL_PER_PERFORATED_INTERVALFLOATCalculated cumulative oil production per foot of PLL (BBL/FT)
CUM_WATERFLOATCalculated cumulative water production (MBBL)
CUM_WATER_PER_PERFORATED_INTERVALFLOATCalculated cumulative water production per foot of PLL (BBL/FT)
FIRST_12_BOEFLOATCalculated first 12 months of BOE production (MBOE)
FIRST_12_BOE_PER_PERFORATED_INTERVALFLOATCalculated first 12 months of BOE production per foot of PLL (BOE/FT)
FIRST_12_GASFLOATCalculated first 12 months of gas production (MMCF)
FIRST_12_GAS_PER_PERFORATED_INTERVALFLOATCalculated first 12 months of gas production per foot of PLL (MCF/FT)
FIRST_12_GORFLOATCalculated first 12 months of GOR production (CF/BBL)
FIRST_12_MMCFGEFLOATCalculated first 12 months of MMCFGE production (MMCFE)
FIRST_12_MMCFGE_PER_PERFORATED_INTERVALFLOATCalculated first 12 months of MMCFGE production per foot of PLL (MMCFE/FT)
FIRST_12_OILFLOATCalculated first 12 months of oil production (MBBL)
FIRST_12_OIL_PER_PERFORATED_INTERVALFLOATCalculated first 12 months of oil production per foot of PLL (BBL/FT)
FIRST_12_WATERFLOATCalculated first 12 months of water production (MBBL)
FIRST_12_WATER_PER_PERFORATED_INTERVALFLOATCalculated first 12 months of water production per foot of PLL (BBL/FT)
FIRST_6_BOEFLOATCalculated first 6 months of BOE production (MBOE)
FIRST_6_BOE_PER_PERFORATED_INTERVALFLOATCalculated first 6 months of BOE production per foot of PLL (BOE/FT)
FIRST_6_GASFLOATCalculated first 6 months of gas production (MMCF)
FIRST_6_GAS_PER_PERFORATED_INTERVALFLOATCalculated first 6 months of gas production per foot of PLL (MCF/FT)
FIRST_6_GORFLOATCalculated first 6 months of GOR production (CF/BBL)
FIRST_6_MMCFGEFLOATCalculated first 6 months of MMCFGE production (MMCFE)
FIRST_6_MMCFGE_PER_PERFORATED_INTERVALFLOATCalculated first 6 months of MMCFGE production per foot of PLL (MCFE/FT)
FIRST_6_OILFLOATCalculated first 6 months of oil production (MBBL)
FIRST_6_OIL_PER_PERFORATED_INTERVALFLOATCalculated first 6 months of oil production per foot of PLL (BBL/FT)
FIRST_6_WATERFLOATCalculated first 6 months of water production (MBBL)
FIRST_6_WATER_PER_PERFORATED_INTERVALFLOATCalculated first 6 months of water production per foot of PLL (BBL/FT)
HAS_DAILYBOOLEANDenotes if a well has daily production data
HAS_DIRECTIONAL_SURVEYBOOLEANDenotes if a well has directional survey data
HAS_MONTHLYBOOLEANDenotes if a well has monthly production data
LAST_12_BOEFLOATCalculated last 12 months of BOE production (MBOE)
LAST_12_BOE_PER_PERFORATED_INTERVALFLOATCalculated last 12 months of BOE production per foot of PLL (BOE/FT)
LAST_12_GASFLOATCalculated last 12 months of gas production (MMCF)
LAST_12_GAS_PER_PERFORATED_INTERVALFLOATCalculated last 12 months of gas production per foot of PLL (MCF/FT)
LAST_12_GORFLOATCalculated last 12 months of GOR production (CF/BBL)
LAST_12_MMCFGEFLOATCalculated last 12 months of MMCFGE production (MMCFE)
LAST_12_MMCFGE_PER_PERFORATED_INTERVALFLOATCalculated last 12 months of MMCFGE production per foot of PLL (MCFE/FT)
LAST_12_OILFLOATCalculated last 12 months of oil production (MBBL)
LAST_12_OIL_PER_PERFORATED_INTERVALFLOATCalculated last 12 months of oil production per foot of PLL (BBL/FT)
LAST_12_WATERFLOATCalculated last 12 months of water production (MBBL)
LAST_12_WATER_PER_PERFORATED_INTERVALFLOATCalculated last 12 months of water production per foot of PLL (BBL/FT)
LAST_MONTH_BOEFLOATCalculated last month of BOE production (MBOE)
LAST_MONTH_BOE_PER_PERFORATED_INTERVALFLOATCalculated last month of BOE production per foot of PLL (BOE/FT)
LAST_MONTH_GASFLOATCalculated last month of gas production (MMCF)
LAST_MONTH_GAS_PER_PERFORATED_INTERVALFLOATCalculated last month of gas production per foot of PLL (MCF/FT)
LAST_MONTH_GORFLOATCalculated last month of GOR production (CF/BBL)
LAST_MONTH_MMCFGEFLOATCalculated last month of MMCFGE production (MMCFE)
LAST_MONTH_MMCFGE_PER_PERFORATED_INTERVALFLOATCalculated last month of MMCFGE production per foot of PLL (MCFE/FT)
LAST_MONTH_OILFLOATCalculated last month of oil production (MBBL)
LAST_MONTH_OIL_PER_PERFORATED_INTERVALFLOATCalculated last month of oil production per foot of PLL (BBL/FT)
LAST_MONTH_WATERFLOATCalculated last month of water production (MBBL)
LAST_MONTH_WATER_PER_PERFORATED_INTERVALFLOATCalculated last month of water production per foot of PLL (BBL/FT)
MONTH_PRODUCEDNUMBER(38,9)Months produced (calculated from production data)

6.10 Gatherers and EUR

ColumnData TypeDescription
GAS_GATHERERVARCHARGas gatherer
GAS_SHRUNK_EURFLOATGas shrunk EUR applied to header after econ run (MMCF)
GAS_SHRUNK_EUR_OVER_PLLFLOATGas shrunk EUR per foot of PLL applied to header after econ run (MCF/FT)
NGL_GATHERERVARCHARNGL gatherer
NGL_SHRUNK_EURFLOATNGL shrunk EUR applied to header after econ run (MBBL)
NGL_SHRUNK_EUR_OVER_PLLFLOATNGL shrunk EUR per foot of PLL applied to header after econ run (BBL/FT)
OIL_GATHERERVARCHAROil gatherer
OIL_SHRUNK_EURFLOATOil shrunk EUR applied to header after econ run (MBBL)
OIL_SHRUNK_EUR_OVER_PLLFLOATOil shrunk EUR per foot of PLL applied to header after econ run (BBL/FT)

6.11 Economics

ColumnData TypeDescription
BEFORE_INCOME_TAX_CASH_FLOWFLOATBefore income tax cash flow applied to well header after econ run (M$)
GAS_BREAKEVENFLOATGas breakeven price applied to header from econ run ($/MMBTU)
IRRFLOATInternal rate of return applied to header after econ run (%)
NRI_OILFLOATOil net revenue interest applied to header after econ run (%)
OIL_BREAKEVENFLOATOil breakeven price applied to header after econ run ($/BBL)
PAYOUT_DURATIONNUMBER(38,9)Payout duration applied to header after econ run (months)
UNDISCOUNTED_ROIFLOATUndiscounted return on investment applied to header from econ run
WI_OILFLOATOil working interest applied to header from econ run (%)

6.12 Reserves classification (PRMS)

ColumnData TypeDescription
PRMS_RESERVES_CATEGORYVARCHARPRMS reserves category
PRMS_RESERVES_SUB_CATEGORYVARCHARPRMS reserves sub-category
PRMS_RESOURCES_CLASSVARCHARPRMS class

6.13 Import metadata

ColumnData TypeDescription
MOST_RECENT_IMPORT_DESCVARCHARMost recent import name
MOST_RECENT_IMPORT_TYPEVARCHARMost recent import type

6.14 Custom fields

ColumnData TypeDescription
CUSTOM_BOOL_0BOOLEANCustom boolean header #0
CUSTOM_BOOL_1BOOLEANCustom boolean header #1
CUSTOM_BOOL_2BOOLEANCustom boolean header #2
CUSTOM_BOOL_3BOOLEANCustom boolean header #3
CUSTOM_BOOL_4BOOLEANCustom boolean header #4
CUSTOM_DATE_0DATECustom date header #0
CUSTOM_DATE_1DATECustom date header #1
CUSTOM_DATE_2DATECustom date header #2
CUSTOM_DATE_3DATECustom date header #3
CUSTOM_DATE_4DATECustom date header #4
CUSTOM_DATE_5DATECustom date header #5
CUSTOM_DATE_6DATECustom date header #6
CUSTOM_DATE_7DATECustom date header #7
CUSTOM_DATE_8DATECustom date header #8
CUSTOM_DATE_9DATECustom date header #9
CUSTOM_DATE_10DATECustom date header #10
CUSTOM_DATE_11DATECustom date header #11
CUSTOM_DATE_12DATECustom date header #12
CUSTOM_DATE_13DATECustom date header #13
CUSTOM_DATE_14DATECustom date header #14
CUSTOM_DATE_15DATECustom date header #15
CUSTOM_DATE_16DATECustom date header #16
CUSTOM_DATE_17DATECustom date header #17
CUSTOM_DATE_18DATECustom date header #18
CUSTOM_DATE_19DATECustom date header #19
CUSTOM_NUMBER_0FLOATCustom number header #0
CUSTOM_NUMBER_1FLOATCustom number header #1
CUSTOM_NUMBER_2FLOATCustom number header #2
CUSTOM_NUMBER_3FLOATCustom number header #3
CUSTOM_NUMBER_4FLOATCustom number header #4
CUSTOM_NUMBER_5FLOATCustom number header #5
CUSTOM_NUMBER_6FLOATCustom number header #6
CUSTOM_NUMBER_7FLOATCustom number header #7
CUSTOM_NUMBER_8FLOATCustom number header #8
CUSTOM_NUMBER_9FLOATCustom number header #9
CUSTOM_NUMBER_10FLOATCustom number header #10
CUSTOM_NUMBER_11FLOATCustom number header #11
CUSTOM_NUMBER_12FLOATCustom number header #12
CUSTOM_NUMBER_13FLOATCustom number header #13
CUSTOM_NUMBER_14FLOATCustom number header #14
CUSTOM_NUMBER_15FLOATCustom number header #15
CUSTOM_NUMBER_16FLOATCustom number header #16
CUSTOM_NUMBER_17FLOATCustom number header #17
CUSTOM_NUMBER_18FLOATCustom number header #18
CUSTOM_NUMBER_19FLOATCustom number header #19
CUSTOM_STRING_0VARCHARCustom string header #0
CUSTOM_STRING_1VARCHARCustom string header #1
CUSTOM_STRING_2VARCHARCustom string header #2
CUSTOM_STRING_3VARCHARCustom string header #3
CUSTOM_STRING_4VARCHARCustom string header #4
CUSTOM_STRING_5VARCHARCustom string header #5
CUSTOM_STRING_6VARCHARCustom string header #6
CUSTOM_STRING_7VARCHARCustom string header #7
CUSTOM_STRING_8VARCHARCustom string header #8
CUSTOM_STRING_9VARCHARCustom string header #9
CUSTOM_STRING_10VARCHARCustom string header #10
CUSTOM_STRING_11VARCHARCustom string header #11
CUSTOM_STRING_12VARCHARCustom string header #12
CUSTOM_STRING_13VARCHARCustom string header #13
CUSTOM_STRING_14VARCHARCustom string header #14
CUSTOM_STRING_15VARCHARCustom string header #15
CUSTOM_STRING_16VARCHARCustom string header #16
CUSTOM_STRING_17VARCHARCustom string header #17
CUSTOM_STRING_18VARCHARCustom string header #18
CUSTOM_STRING_19VARCHARCustom string header #19
CUSTOM_STRING_20VARCHARCustom string header #20
CUSTOM_STRING_21VARCHARCustom string header #21
CUSTOM_STRING_22VARCHARCustom string header #22
CUSTOM_STRING_23VARCHARCustom string header #23
CUSTOM_STRING_24VARCHARCustom string header #24
CUSTOM_STRING_25VARCHARCustom string header #25
CUSTOM_STRING_26VARCHARCustom string header #26
CUSTOM_STRING_27VARCHARCustom string header #27
CUSTOM_STRING_28VARCHARCustom string header #28
CUSTOM_STRING_29VARCHARCustom string header #29
CUSTOM_STRING_30VARCHARCustom string header #30
CUSTOM_STRING_31VARCHARCustom string header #31
CUSTOM_STRING_32VARCHARCustom string header #32
CUSTOM_STRING_33VARCHARCustom string header #33
CUSTOM_STRING_34VARCHARCustom string header #34

6.15 Integration metadata

ColumnData TypeDescription
__RECORD_SOURCEVARCHARIndicates if data was originated in ComboCurve or your org
__CREATED_ATTIMESTAMP_NTZ(9)Integration creation date
__UPDATED_ATTIMESTAMP_NTZ(9)Integration updated date
__SOFT_DELETEBOOLEANIntegration soft delete

6.16 Other

ColumnData TypeDescription
ABSTRACTVARCHARAbstract
ALLOCATION_TYPEVARCHARAllocation type
BOFLOATOil factor
RIGVARCHARRig name
STATUSVARCHARWell status
TILDATETurn in line date

7. Incremental consumption best practices

Pull only new or changed records

For scheduled ingestion, pull records where __UPDATED_AT is greater than your last successful ingestion watermark (and optionally include a small lookback window to capture late updates).

Deduplicate by the secure-view key

Even when consuming incrementally, treat ID or CHOSEN_ID + DATASOURCE + PROJECT_NAME as the record key and upsert accordingly. The secure view always resolves to the latest version for that key.


8. Operational notes

  • Latest-row logic: The secure view selects the most recent record per WELL_ID or CHOSEN_ID + DATASOURCE + PROJECT_NAME using COALESCE(__UPDATED_AT, __CREATED_AT) ordering.
  • Late revisions: Well data can be corrected after initial availability; use incremental pulls driven by __UPDATED_AT and consider a small backfill window.
  • Custom fields: CUSTOM_XXXX_XX are optional “slots” for client- or source-specific well-attribute fields. Their meaning is tenant-dependent.