lsst.daf.persistence  14.0
 All Classes Namespaces Files Functions Variables Typedefs Friends Macros
Public Member Functions | Public Attributes | Static Public Attributes | List of all members
lsst.daf.persistence.registries.SqlRegistry Class Reference
Inheritance diagram for lsst.daf.persistence.registries.SqlRegistry:
lsst.daf.persistence.registries.Registry lsst.daf.persistence.registries.PgsqlRegistry lsst.daf.persistence.registries.SqliteRegistry

Public Member Functions

def __init__
 
def lookup
 
def executeQuery
 
- Public Member Functions inherited from lsst.daf.persistence.registries.Registry
def __init__
 

Public Attributes

 conn
 

Static Public Attributes

string placeHolder = "?"
 

Additional Inherited Members

- Static Public Member Functions inherited from lsst.daf.persistence.registries.Registry
def create
 

Detailed Description

A base class for SQL-based registries

Subclasses should define the class variable `placeHolder` (the particular
placeholder to use for parameter substitution) appropriately. The
database's python module should define `paramstyle` (see PEP 249), which
would indicate what to use for a placeholder:
* paramstyle = "qmark" --> placeHolder = "?"
* paramstyle = "format" --> placeHolder = "%s"
Other `paramstyle` values are not currently supported.

Constructor parameters
----------------------
conn : DBAPI connection object
    Connection object

Definition at line 289 of file registries.py.

Constructor & Destructor Documentation

def lsst.daf.persistence.registries.SqlRegistry.__init__ (   self,
  conn 
)
Constructor.

Parameters
----------
conn : DBAPI connection object
    Connection object

Definition at line 307 of file registries.py.

Member Function Documentation

def lsst.daf.persistence.registries.SqlRegistry.executeQuery (   self,
  returnFields,
  joinClause,
  whereFields,
  range,
  values 
)
Extract metadata from the registry.
@param returnFields (list of strings) Metadata fields to be extracted.
@param joinClause   (list of strings) Tables in which metadata fields
            are located.
@param whereFields  (list of tuples) First tuple element is metadata
            field to query; second is the value that field
            must have (often '?').
@param range        (tuple) Value, lower limit, and upper limit for a
            range condition on the metadata.  Any of these can
            be metadata fields.
@param values       (tuple) Tuple of values to be substituted for '?'
            characters in the whereFields values or the range
            values.
@return (list of tuples) All sets of field values that meet the
criteria

Definition at line 364 of file registries.py.

def lsst.daf.persistence.registries.SqlRegistry.lookup (   self,
  lookupProperties,
  reference,
  dataId,
  kwargs 
)
Perform a lookup in the registry.

Return values are refined by the values in dataId.
Returns a list of values that match keys in lookupProperties.
e.g. if the template is 'raw/raw_v%(visit)d_f%(filter)s.fits.gz', and
dataId={'visit':1}, and lookupProperties is ['filter'], and the
filesystem under self.root has exactly one file 'raw/raw_v1_fg.fits.gz'
then the return value will be [('g',)]

:param lookupProperties:
:param dataId: must be an iterable. Keys must be string.
If key is a string then will look for elements in the repository that match value for key.
If key is a 2-item iterable then will look for elements in the repository where the value is between
the values of key[0] and key[1].
:param reference: other data types that may be used to search for values.
:param **kwargs: nothing needed for sqlite lookup
:return: a list of values that match keys in lookupProperties.

Definition at line 318 of file registries.py.

Member Data Documentation

lsst.daf.persistence.registries.SqlRegistry.conn

Definition at line 316 of file registries.py.

string lsst.daf.persistence.registries.SqlRegistry.placeHolder = "?"
static

Definition at line 305 of file registries.py.


The documentation for this class was generated from the following file: