SQL-169: LocationQueryProvider.GetPrimaryLocation¶

This statement is a read operation invoked through ORM (NHibernate LINQ). Executed by LocationQueryProvider.GetPrimaryLocation.

Classification¶

Field	Value
SQL ID	SQL-169
Operation type	Read
Execution method	ORM (NHibernate LINQ)
Database	Oracle*
Schema	[unqualified]**
Command type	N/A (ORM-generated)
Business object	`LocationQueryProvider`
Criteria property	N/A — ORM
Lifecycle method	`GetPrimaryLocation`

Parameters¶

Parameter	Direction	Type	Max length	Description
`policyNumber`	Input	long	N/A	Method argument of `LocationQueryProvider.GetPrimaryLocation` bound into the ORM expression; NHibernate generates the bind variable at runtime

Tables¶

Table	Access	Columns used
LOCATION	SELECT	LOC_SEQ_NUM, POLICY_NUM, BUS_SEQ_NUM, AGENT_NUM, PARENT_LOC_SEQ_NUM, LOC_EFF_DATE, LOC_EXP_DATE, LOCATION_CODE, LOCATION_NAME, LOC_ADDR1, LOC_ADDR2, LOC_CITY, LOC_COUNTRY, LOC_PHONE, LOC_PHONE_EXT, LOC_FAX, LOC_STATE, LOC_ZIP, LOC_ZIP4, SIC_CODE, PROVIDER_NUM, CREATE_USER, CREATE_DATE, UPDATE_USER, UPDATE_DATE, USPS_BARCODE, EMAIL_ADDR, EMPLOYEE_COUNT, LOC_ADDR3, PRIMARY_LOCATION_FLAG, CELL_PHONE, LOC_COUNTY

LINQ statement¶

Source: Data/SAIF.Data/Queries/Locations/LocationQueryProvider.cs:33-37.

public Location GetPrimaryLocation(long policyNumber)
{
    return Factory.GetRepository<Location>()
        .Query()
        .Where(x => x.PolicyNum == policyNumber && x.ExpirationDate == null && (x.LocationCode == "BUS"))
        .OrderBy(x => x.AddressLine1)
        .SingleOrDefault(x => x.IsPrimaryLocation && x.ExpirationDate == null);
}

Sample SQL¶

Inferred SQL: This SQL was inferred from the LINQ statement above and the NHibernate mappings. It is not concrete SQL from source code; NHibernate generates the executed statement at runtime, so aliases, column order, join syntax, and bind-parameter names may differ.

-- Inferred from LINQ (NHibernate mapping translation); not concrete SQL
SELECT
  L.LOC_SEQ_NUM,
  L.POLICY_NUM,
  L.BUS_SEQ_NUM,
  L.AGENT_NUM,
  L.PARENT_LOC_SEQ_NUM,
  L.LOC_EFF_DATE,
  L.LOC_EXP_DATE,
  L.LOCATION_CODE,
  L.LOCATION_NAME,
  L.LOC_ADDR1,
  L.LOC_ADDR2,
  L.LOC_CITY,
  L.LOC_COUNTRY,
  L.LOC_PHONE,
  L.LOC_PHONE_EXT,
  L.LOC_FAX,
  L.LOC_STATE,
  L.LOC_ZIP,
  L.LOC_ZIP4,
  L.SIC_CODE,
  L.PROVIDER_NUM,
  L.CREATE_USER,
  L.CREATE_DATE,
  L.UPDATE_USER,
  L.UPDATE_DATE,
  L.USPS_BARCODE,
  L.EMAIL_ADDR,
  L.EMPLOYEE_COUNT,
  L.LOC_ADDR3,
  L.PRIMARY_LOCATION_FLAG,
  L.CELL_PHONE,
  L.LOC_COUNTY
FROM LOCATION L
WHERE L.POLICY_NUM = :policyNumber
  AND L.LOC_EXP_DATE IS NULL
  AND L.LOCATION_CODE = 'BUS'
  AND L.PRIMARY_LOCATION_FLAG = 'Y'
  AND L.LOC_EXP_DATE IS NULL
ORDER BY L.LOC_ADDR1
-- SingleOrDefault: NHibernate expects at most one row

Translation notes: - The SingleOrDefault(predicate) predicate is ANDed with the preceding Where. The duplicate LOC_EXP_DATE IS NULL is kept as written; the optimizer removes it. - IsPrimaryLocation → PRIMARY_LOCATION_FLAG, YesNoType → 'Y'. - The literal "BUS" is a C# constant. NHibernate typically parameterizes constants, but it is shown inline for readability. - OrderBy is kept before SingleOrDefault; the order does not change the result of a single-row read.

Operations and processes¶

Location lookups

Business rules¶

SD-BR-062 Location code and contact-type precedence

Sources¶

Data/SAIF.Data/Queries/Locations/LocationQueryProvider.cs:33