Current File : //usr/lib/python2.7/site-packages/salt/states/sqlite3.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l m Z y d d l Z e Z Wn e
k
ra e Z n Xd � Z d d � Z d e d � Z d � Z e d � Z d d
� Z d � Z d � Z d S(
u�
Management of SQLite3 databases
===============================
.. versionadded:: 2016.3.0
:depends: - SQLite3 Python Module
:configuration: See :py:mod:`salt.modules.sqlite3` for setup instructions
The sqlite3 module is used to create and manage sqlite3 databases
and execute queries
Here is an example of creating a table using sql statements:
.. code-block:: yaml
users:
sqlite3.table_present:
- db: /var/www/data/app.sqlite
- schema: CREATE TABLE `users` (`username` TEXT COLLATE NOCASE UNIQUE NOT NULL, `password` BLOB NOT NULL, `salt` BLOB NOT NULL, `last_login` INT)
Here is an example of creating a table using yaml/jinja instead of sql:
.. code-block:: yaml
users:
sqlite3.table_present:
- db: /var/www/app.sqlite
- schema:
- email TEXT COLLATE NOCASE UNIQUE NOT NULL
- firstname TEXT NOT NULL
- lastname TEXT NOT NULL
- company TEXT NOT NULL
- password BLOB NOT NULL
- salt BLOB NOT NULL
Here is an example of making sure a table is absent:
.. code-block:: yaml
badservers:
sqlite3.table_absent:
- db: /var/www/data/users.sqlite
Sometimes you would to have specific data in tables to be used by other services
Here is an example of making sure rows with specific data exist:
.. code-block:: yaml
user_john_doe_xyz:
sqlite3.row_present:
- db: /var/www/app.sqlite
- table: users
- where_sql: email='john.doe@companyxyz.com'
- data:
email: john.doe@companyxyz.com
lastname: doe
firstname: john
company: companyxyz.com
password: abcdef012934125
salt: abcdef012934125
- require:
- sqlite3: users
Here is an example of removing a row from a table:
.. code-block:: yaml
user_john_doe_abc:
sqlite3.row_absent:
- db: /var/www/app.sqlite
- table: users
- where_sql: email="john.doe@companyabc.com"
- require:
- sqlite3: users
Note that there is no explicit state to perform random queries, however, this
can be approximated with sqlite3's module functions and module.run:
.. code-block:: yaml
zone-delete:
module.run:
- name: sqlite3.modify
- db: {{ db }}
- sql: "DELETE FROM records WHERE id > {{ count[0] }} AND domain_id = {{ domain_id }}"
- watch:
- sqlite3: zone-insert-12
i ( t absolute_importt unicode_literalst print_function( t sixNc C@ s t S( u6
Only load if the sqlite3 module is available
( t HAS_SQLITE3( ( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyt __virtual__n s c
C@ s i | d 6i d 6d d 6d d 6} d } z�y�t j | d t j �} t | _ d } | d k r t | d | d | � } n t | d | d | | � } t | � d k r� t | d <d
| d <n� t | � d k r�t d rt
| d <d | | d <| d
| d d <q�| d k r9| j d | d | � } n | j d | d | | � } | j � | j
d k r�t
| d <d | d <| d
| d d <q�t | d <d | d <n t
| d <d | d <Wn0 t k
r�} t | d <t j | � | d <n XWd | r| j � n X| S( ux
Makes sure the specified row is absent in db. If multiple rows
match where_sql, then the state will fail.
name
Only used as the unique ID
db
The database file name
table
The table name to check
where_sql
The sql to select the row to check
where_args
The list parameters to substitute in where_sql
u nameu changesu resultu u commentt detect_typesu SELECT * FROM `u ` WHERE i u- More than one row matched the specified queryu testu Row will be removed in i u oldu
DELETE FROM `u Row removedu Unable to remove rowu
Row is absentN( t Nonet sqlite3t connectt PARSE_DECLTYPESt
_dict_factoryt row_factoryt _queryt lent Falset __opts__t Truet executet committ rowcountt ExceptionR t text_typet close(
t namet dbt tablet where_sqlt
where_argst changest connt rowst cursort e( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyt
row_absentu sZ
c C@ s2 i | d 6i d 6d# d 6d d 6} d# } z�y�t j | d t j �} t | _ d# } | d# k r t | d | d | � } n t | d | d | | � } t | � d k r� t | d <d
| d <n t | � d k r�x�t j
| � D]�\ }
} |
| d k r� | d |
| k r� | rXt d rCt | d <d
| | d <qqg } g }
x? t j
| � D]. \ }
} | j
d |
d � |
j
| � q_W| d# k r�|
| 7}
n d | d } | d j | � 7} | d 7} | | 7} | j | |
� } | j � | j d k rAt | d <d | d <| d | d d <| | d d <qqt | d <d | d <qtt | d <d d | d <Pq� q� W| d d# k r�t | d <d | d <q�n@t d r�t | d <| | d d <d | | d <n
g } g } g } xL t j
| � D]; \ }
} | j
d � | j
| � | j
d |
d � q�Wd | d } | d j | � 7} | d 7} | d j | � 7} | d 7} | j | | � } | j � | j d k r�t | d <| | d d <d! | d <n t | d <d" | d <Wn0 t k
r} t | d <t j | � | d <n XWd# | r-| j � n X| S($ u�
Checks to make sure the given row exists. If row exists and update is True
then row will be updated with data. Otherwise it will leave existing
row unmodified and check it against data. If the existing data
doesn't match data_check the state will fail. If the row doesn't
exist then it will insert data into the table. If more than one
row matches, then the state will fail.
name
Only used as the unique ID
db
The database file name
table
The table name to check the data
data
The dictionary of key/value pairs to check against if
row exists, insert into the table if it doesn't
where_sql
The sql to select the row to check
where_args
The list parameters to substitute in where_sql
update
True will replace the existing row with data
When False and the row exists and data does not equal
the row data then the state will fail
u nameu changesu resultu u commentR u SELECT * FROM `u ` WHERE i u- More than one row matched the specified queryi u testu Row will be update in u `u `=?u UPDATE `u ` SET u ,u WHERE u Row updatedu oldu newu Row update failedu Existing data doesu not match desired stateu
Row existsu Row will be inserted into u ?u
INSERT INTO `u ` (u
) VALUES (u )u Inserted rowu Unable to insert dataN( R R R R
R R R
R R R t iteritemsR R t appendt joinR R R R R R ( R R R t dataR R t updateR R R t keyt valuet columnst paramst sqlR t
value_stmtt valuesR! ( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyt row_present� s� '
$
c C@ s� i | d 6i d 6d d 6d d 6} d } zDy
t j | d t j �} t | d d | g � } t | � d k r� t d
r� t | d <d | d | d <q7| j d
| � | j � | d d | d d <t | d <d | d | d <nM t | � d k rt | d <d | d | d <n t
| d <d | d | d <Wn0 t k
rj} t
| d <t j
| � | d <n XWd | r�| j � n X| S( u�
Make sure the specified table does not exist
name
The name of the table
db
The name of the database file
u nameu changesu resultu u commentR u SELECT sql FROM sqlite_master u WHERE type='table' AND name=?i u testu 'u ' will be droppedu DROP TABLE i u oldu
' was droppedu ' is already absentu$ Multiple tables with the same name='N( R R R R
R
R R R R R R R R R R ( R R R R t tablesR! ( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyt table_absentN s<
c C@ s� i | d 6i d 6d d 6d d 6} d } z�yrt j | d t j �} t | d d | g � } t | � d k r�d } t | t j � r� | j � } n t
| | � } | | d
d
k r�| r}t d rt | d <| d
d
| d d <| | d d
<d | d | d <q�| j
d | d � | j
| � | j � t | d <| d
d
| d d <| | d d
<d | d | d <q�t | d <d | d | d
d
| d <q�t | d <d | d | d <n� t | � d
k r�d } t | t j � r�| } n t
| | � } t d r@t | d <| | d d
<d | d | d <q�| j
| � | j � t | d <| | d d
<d | d | d <n t | d <d | | d <Wn- t k
r�} t | d <t | � | d <n XWd | r�| j � n X| S( u�
Make sure the specified table exists with the specified schema
name
The name of the table
db
The name of the database file
schema
The dictionary containing the schema information
force
If the name of the table exists and force is set to False,
the state will fail. If force is set to True, the existing
table will be replaced with the new table
u nameu changesu resultu u commentR u SELECT sql FROM sqlite_master u WHERE type='table' AND name=?i i u testu oldu newu 'u ' will be replacedu DROP TABLE `u `u
Replaced 'u Expected schema=u
actual schema=u ' exists with matching schemau ' will be createdu Created table 'u# Multiple tables with the same name=N( R R R R
R
R t
isinstanceR t string_typest stript _get_sql_from_schemaR R R R R R t strR ( R R t schemat forceR R R0 R, R! ( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyt
table_present sr
!
c C@ s@ d } | d k r$ | j | � } n | j | | � } | j � S( N( R R t fetchall( R R, t
parametersR ( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyR
� s
c C@ s d | d d j | � d S( Nu CREATE TABLE `u ` (u ,u )( R% ( R R7 ( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyR5 � s c C@ s< i } x/ t | j � D] \ } } | | | | d <q W| S( Ni ( t enumeratet description( R t rowt dt idxt col( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyR � s ( t __doc__t
__future__R R R t salt.extR R R R t ImportErrorR R R R" R/ R1 R9 R
R5 R ( ( ( s7 /usr/lib/python2.7/site-packages/salt/states/sqlite3.pyt <module>^ s
R � 1 [
Mini Shell