Current File : //usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l
m Z d d l m
Z
d d l m Z d d l Z d Z e j e � Z d Z e Z yf d d l m Z d d
l m Z d d l m Z m Z m Z d d l m Z d d
l! m" Z" e# Z Wn e$ k
r(n Xd � Z% d � Z& e d d � Z( d � Z) d d d d d d � Z* d d d d d � Z+ d d d d d d � Z, d d d d d � Z- d d d d d � Z. d d d d d � Z/ d d d d d d � Z0 d d d d d � Z1 d d d d d d d d � Z2 d d d d d � Z3 d d d d d � Z4 e d d d d d � Z5 d d d d d d d d d! � Z6 d d d d d d d d" � Z7 d S(# u�
Cassandra Database Module
.. versionadded:: 2015.5.0
This module works with Cassandra v2 and v3 and hence generates
queries based on the internal schema of said version.
:depends: DataStax Python Driver for Apache Cassandra
https://github.com/datastax/python-driver
pip install cassandra-driver
:referenced by: Salt's cassandra_cql returner
:configuration:
The Cassandra cluster members and connection port can either be specified
in the master or minion config, the minion's pillar or be passed to the module.
Example configuration in the config for a single node:
.. code-block:: yaml
cassandra:
cluster: 192.168.50.10
port: 9000
Example configuration in the config for a cluster:
.. code-block:: yaml
cassandra:
cluster:
- 192.168.50.10
- 192.168.50.11
- 192.168.50.12
port: 9000
username: cas_admin
.. versionchanged:: 2016.11.0
Added support for ``ssl_options`` and ``protocol_version``.
Example configuration with
`ssl options <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Cluster.ssl_options>`_:
If ``ssl_options`` are present in cassandra config the cassandra_cql returner
will use SSL. SSL isn't used if ``ssl_options`` isn't specified.
.. code-block:: yaml
cassandra:
cluster:
- 192.168.50.10
- 192.168.50.11
- 192.168.50.12
port: 9000
username: cas_admin
ssl_options:
ca_certs: /etc/ssl/certs/ca-bundle.trust.crt
# SSL version should be one from the ssl module
# This is an optional parameter
ssl_version: PROTOCOL_TLSv1
Additionally you can also specify the ``protocol_version`` to
`use <http://datastax.github.io/python-driver/api/cassandra/cluster.html#cassandra.cluster.Cluster.ssl_options>`_.
.. code-block:: yaml
cassandra:
cluster:
- 192.168.50.10
- 192.168.50.11
- 192.168.50.12
port: 9000
username: cas_admin
# defaults to 4, if not set
protocol_version: 3
i ( t absolute_importt unicode_literalst print_functionN( t CommandExecutionError( t six( t rangeu ssl_versionu
cassandra_cql( t Cluster( t NoHostAvailable( t ConnectionExceptiont ConnectionShutdownt OperationTimedOut( t PlainTextAuthProvider( t dict_factoryc C@ s t r
t St d f S( u�
Return virtual name of the module only if the python driver can be loaded.
:return: The virtual name of the module.
:rtype: str
u9 Cannot load cassandra_cql module: python driver not found( t
HAS_DRIVERt __virtualname__t False( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt __virtual__w s c C@ s t j d | � d S( Nu, Cassandra_cql asynchronous call returned: %s( t logt error( t errors( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt _async_log_errors� s c C@ s� | s� t j d � y t d d � } Wn& t k
rO } t j d | � � n X| j | � } | s� | r� t j d | | � | } q� t j d | � t d j | � � � n | S| S( uB
Load properties for the cassandra module from config or pillar.
:param property_name: The property to load.
:type property_name: str or list of str
:param config_option: The name of the config option.
:type config_option: str
:param set_default: Should a default be set if not found in config.
:type set_default: bool
:param default: The default value to be set.
:type default: str or int
:return: The property fetched from the configuration or default.
:rtype: str or list of str
uI No property specified in function, trying to load from salt configurationu
config.optionu cassandrau2 Failed to get cassandra config options. Reason: %su" Setting default Cassandra %s to %suG No cassandra %s specified in the configuration or passed to the module.u% ERROR: Cassandra {0} cannot be empty.( R t debugt __salt__t
BaseExceptionR t getR t format( t
property_namet
config_optiont set_defaultt defaultt optionst et loaded_property( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt _load_properties� s
c C@ s� t d d � j d d � } i } | r� | d | d <t | k r� | t j d � s� d j g t t � D] } | j d � rh | ^ qh � } t d j | � � � q� t
t | t � | t <n | Sd Sd S( u�
Parse out ssl_options for Cassandra cluster connection.
Make sure that the ssl_version (if any specified) is valid.
u
config.optionu cassandrau ssl_optionsu ca_certsu PROTOCOL_u , u� Invalid protocol_version specified! Please make sure that the ssl protocolversion is one from the SSLmodule. Valid options are {0}N( R R t Nonet SSL_VERSIONt
startswitht joint dirt sslR R t getattr( t ssloptst ssl_optst xt
valid_opts( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt
_get_ssl_opts� s 1 c
C@ sL t r0 d t k r0 d t k r0 t d t d f St d | d d � } t | t � rZ | n | j d � } t d | d d d t d d
� } t d | d d d t d d � } t d | d d
d t d d � } t d | d d d t d d � } yt d | d | � } t � } | rAt | d | d | d | d | d t �} n$ t | d | d | d | d t �} x^ t d d � D]M } y | j
� } PWqut k
r�t j
d | � | d k r�� q�quXquW| t d <| t d <i t d <t j d | � | | f SWnF t k
rn6 t t t f k
rGt j d | � t d � � n Xd S( u�
Connect to a Cassandra cluster.
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str or list of str
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:param protocol_version: Cassandra protocol version to use.
:type port: int
:return: The session and cluster objects.
:rtype: cluster object, session object
u cassandra_cql_returner_clusteru cassandra_cql_returner_sessionR R u clusteru ,u portR R iR# u usernameu cassandrau passwordu protocol_versioni t usernamet passwordt portt
auth_providert ssl_optionst protocol_versiont compressioni u+ Cassandra cluster.connect timed out, try %si u cassandra_cql_preparedu1 Successfully connected to Cassandra cluster at %su, Could not connect to Cassandra cluster at %su. ERROR: Could not connect to Cassandra cluster.N( t __context__R! t
isinstancet listt splitt TrueR R- R R t connectR
R t warningR t TypeErrorR R R R R (
t contact_pointsR0 t cql_usert cql_passR3 R1 R* t clustert
recontimest session( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt _connect� sX $!!!
c C@ s y+ t d | d | d | d | � \ } } WnF t k
rN t j d � � n& t k
rs } t j d | � � n Xt | _ g } t | t � r't d | d | d | d | � } t
j d | � }
|
j � \ } } }
y | | } Wn) t
k
r| j | t | � � } n Xt j d | � n y | j | � } WnD t k
r�} t j d | | � d
j | | � } t | � � n X| rx� | D]� } i } xf t j | � D]U \ } } t | t j � s�t | t t t f � s�t j | � } q�n | | | <q�W| j | � q�Wn | S( u�
Run a query on a Cassandra cluster and return a dictionary.
:param query: The query to execute.
:type query: str
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:param params: The parameters for the query, optional.
:type params: str
:return: A dictionary from the return values of the query
:rtype: list[dict]
CLI Example:
.. code-block:: bash
salt 'cassandra-server' cassandra_cql.cql_query "SELECT * FROM users_by_name WHERE first_name = 'jane'"
R= R0 R> R? u( Could not get Cassandra cluster session.u< Unexpected error while getting Cassandra cluster session: %su ^(\d+)\.(\d+)(?:\.(\d+))?u New query is: %su' Failed to execute query: %s
reason: %su. ERROR: Cassandra query failed: {0} reason: {1}( RC R R t criticalR R t row_factoryR6 t dictt versiont ret matcht groupst KeyErrorR t maxR t executeR R R t iteritemst text_typet setR7 t append( t queryR= R0 R> R? R@ RB R t rett cluster_versionRI t majort minort pointt resultst msgt resultt valuest keyt value( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt cql_query sL +
c K@ s% | j d t � } y+ t d | d | d | d | � \ }
} WnF t k
r` t j d � � n& t k
r� } t j d | � � n X| t d k r� y! | j | � }
|
t d | <Wq� t k
r� } t j d | � � q� Xn t d | }
t | _
g } y= | r$| j |
j | � � } n | j
|
j | � � } WnD t k
r�} t j d
| | � d j | | � } t | � � n X| r!| r!x� | D]� } i } xf t j | � D]U \ } } t | t j � s�t | t t t f � s�t j | � } q�n | | | <q�W| j | � q�Wn | S( u
Run a query on a Cassandra cluster and return a dictionary.
This function should not be used asynchronously for SELECTs -- it will not
return anything and we don't currently have a mechanism for handling a future
that will return results.
:param query: The query to execute.
:type query: str
:param statement_name: Name to assign the prepared statement in the __context__ dictionary
:type statement_name: str
:param statement_arguments: Bind parameters for the SQL statement
:type statement_arguments: list[str]
:param async: Run this query in asynchronous mode
:type async: bool
:param callback_errors: Function to call after query runs if there is an error
:type callback_errors: Function callable
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:param params: The parameters for the query, optional.
:type params: str
:return: A dictionary from the return values of the query
:rtype: list[dict]
CLI Example:
.. code-block:: bash
# Insert data asynchronously
salt this-node cassandra_cql.cql_query_with_prepare "name_insert" "INSERT INTO USERS (first_name, last_name) VALUES (?, ?)" statement_arguments=['John','Doe'], asynchronous=True
# Select data, should not be asynchronous because there is not currently a facility to return data from a future
salt this-node cassandra_cql.cql_query_with_prepare "name_select" "SELECT * FROM USERS WHERE first_name=?" statement_arguments=['John']
u asyncR= R0 R> R? u( Could not get Cassandra cluster session.u< Unexpected error while getting Cassandra cluster session: %su cassandra_cql_preparedu2 Unexpected error while preparing SQL statement: %su' Failed to execute query: %s
reason: %su. ERROR: Cassandra query failed: {0} reason: {1}( R R RC R R RD R R5 t prepareR RE t
execute_asynct bindRM R R R RN R6 RO RP R7 RF RQ ( RR t statement_namet statement_argumentst callback_errorsR= R0 R> R? t kwargst asynchronousR@ RB R t bound_statementRS t future_resultsRX RY RZ R[ R\ R] ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt cql_query_with_preparem sL .
c C@ s| d } y t | | | | | � } WnF t k
rE t j d � � n& t k
rj } t j d | � � n X| d j d � S( u
Show the Cassandra version.
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: The version for this Cassandra cluster.
:rtype: str
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.version
salt 'minion1' cassandra_cql.version contact_points=minion1
uR select release_version
from system.local
limit 1;u Could not get Cassandra version.u4 Unexpected error while getting Cassandra version: %si u release_version( R^ R R RD R R ( R= R0 R> R? RR RS R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyRG � s
c C@ su d } i } y t | | | | | � } WnF t k
rK t j d � � n& t k
rp } t j d | � � n X| S( u
Show the Cassandra information for this cluster.
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: The information for this Cassandra cluster.
:rtype: dict
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.info
salt 'minion1' cassandra_cql.info contact_points=minion1
uf select cluster_name,
data_center,
partitioner,
host_id,
rack,
release_version,
cql_version,
schema_version,
thrift_version
from system.local
limit 1;u Could not list Cassandra info.u1 Unexpected error while listing Cassandra info: %s( R^ R R RD R ( R= R0 R> R? RR RS R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt info� s "
c C@ s� i d d 6d d 6} i } y t | | | | | � } WnF t k
rY t j d � � n& t k
r~ } t j d | � � n X| S( u-
List keyspaces in a Cassandra cluster.
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: The keyspaces in this Cassandra cluster.
:rtype: list[dict]
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.list_keyspaces
salt 'minion1' cassandra_cql.list_keyspaces contact_points=minion1 port=9000
u2 select keyspace_name from system.schema_keyspaces;u 2u2 select keyspace_name from system_schema.keyspaces;u 3u Could not list keyspaces.u, Unexpected error while listing keyspaces: %s( R^ R R RD R ( R= R0 R> R? RR RS R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt list_keyspaces* s
c C@ s� | r d j | � n d } i d j | � d 6d j | � d 6} i } y t | | | | | � } WnF t k
r� t j d � � n& t k
r� } t j d | � � n X| S( u&
List column families in a Cassandra cluster for all keyspaces or just the provided one.
:param keyspace: The keyspace to provide the column families for, optional.
:type keyspace: str
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: The column families in this Cassandra cluster.
:rtype: list[dict]
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.list_column_families
salt 'minion1' cassandra_cql.list_column_families contact_points=minion1
salt 'minion1' cassandra_cql.list_column_families keyspace=system
u where keyspace_name = '{0}'u uO select columnfamily_name from system.schema_columnfamilies
{0};u 2uB select column_name from system_schema.columns
{0};u 3u Could not list column families.u2 Unexpected error while listing column families: %s( R R^ R R RD R ( t keyspaceR= R0 R> R? t where_clauseRR RS R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt list_column_familiesT s
c C@ s� i d j | � d 6d j | � d 6} y t | | | | | � } WnF t k
re t j d � � n& t k
r� } t j d | � � n X| r� t St S( uX
Check if a keyspace exists in a Cassandra cluster.
:param keyspace The keyspace name to check for.
:type keyspace: str
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: The info for the keyspace or False if it does not exist.
:rtype: dict
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.keyspace_exists keyspace=system
u^ select keyspace_name from system.schema_keyspaces
where keyspace_name = '{0}';u 2u^ select keyspace_name from system_schema.keyspaces
where keyspace_name = '{0}';u 3u' Could not determine if keyspace exists.u9 Unexpected error while determining if keyspace exists: %s( R R^ R R RD R R9 R ( Rl R= R0 R> R? RR RS R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt keyspace_exists� s
u SimpleStrategyi c
C@ s t | | | � } | si | d 6} | r� t | t j � r� y& t j j j | � }
| j |
� Wq� t k
r� t
j d � t SXq� | j | � n
| | d <d j
| | � } y t | | | | | � Wqt k
r� t
j d � � qt k
r} t
j d | � � qXn d S( u�
Create a new keyspace in Cassandra.
:param keyspace: The keyspace name
:type keyspace: str
:param replication_strategy: either `SimpleStrategy` or `NetworkTopologyStrategy`
:type replication_strategy: str
:param replication_factor: number of replicas of data on multiple nodes. not used if using NetworkTopologyStrategy
:type replication_factor: int
:param replication_datacenters: string or dict of datacenter names to replication factors, required if using
NetworkTopologyStrategy (will be a dict if coming from state file).
:type replication_datacenters: str | dict[str, int]
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: The info for the keyspace or False if it does not exist.
:rtype: dict
CLI Example:
.. code-block:: bash
# CLI Example:
salt 'minion1' cassandra_cql.create_keyspace keyspace=newkeyspace
salt 'minion1' cassandra_cql.create_keyspace keyspace=newkeyspace replication_strategy=NetworkTopologyStrategy replication_datacenters='{"datacenter_1": 3, "datacenter_2": 2}'
u classu, Could not load json replication_datacenters.u replication_factorup create keyspace {0}
with replication = {1}
and durable_writes = true;u Could not create keyspace.u, Unexpected error while creating keyspace: %sN( Ro R6 R t string_typest saltt utilst jsont loadst updateR R R R R R^ R RD (
Rl t replication_strategyt replication_factort replication_datacentersR= R0 R> R? t existing_keyspacet replication_mapt replication_datacenter_mapRR R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt create_keyspace� s. #
c C@ s� t | | | � } | r� d j | � } y t | | | | | � Wq� t k
rd t j d � � q� t k
r� } t j d | � � q� Xn t S( u�
Drop a keyspace if it exists in a Cassandra cluster.
:param keyspace: The keyspace to drop.
:type keyspace: str
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: The info for the keyspace or False if it does not exist.
:rtype: dict
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.drop_keyspace keyspace=test
salt 'minion1' cassandra_cql.drop_keyspace keyspace=test contact_points=minion1
u drop keyspace {0};u Could not drop keyspace.u, Unexpected error while dropping keyspace: %s( Ro R R^ R R RD R R9 ( Rl R= R0 R> R? Ry RR R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt
drop_keyspace� s
c C@ su d } i } y t | | | | | � } WnF t k
rK t j d � � n& t k
rp } t j d | � � n X| S( u
List existing users in this Cassandra cluster.
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:return: The list of existing users.
:rtype: dict
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.list_users
salt 'minion1' cassandra_cql.list_users contact_points=minion1
u list users;u Could not list users.u( Unexpected error while listing users: %s( R^ R R RD R ( R= R0 R> R? RR RS R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt
list_users s
c
C@ s� | r d n d } d j | | | � } t j d | | � y t | | | | | � WnF t k
rw t j d � � n& t k
r� } t j d | � � n Xt S( u�
Create a new cassandra user with credentials and superuser status.
:param username: The name of the new user.
:type username: str
:param password: The password of the new user.
:type password: str
:param superuser: Is the new user going to be a superuser? default: False
:type superuser: bool
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return:
:rtype:
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.create_user username=joe password=secret
salt 'minion1' cassandra_cql.create_user username=joe password=secret superuser=True
salt 'minion1' cassandra_cql.create_user username=joe password=secret superuser=True contact_points=minion1
u superuseru nosuperuseru6 create user if not exists {0} with password '{1}' {2};u= Attempting to create a new user with username=%s superuser=%su Could not create user.u( Unexpected error while creating user: %s( R R R R^ R RD R R9 (
R. R/ t superuserR= R0 R> R? t
superuser_cqlRR R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt create_userD s
u keyspacec
C@ s� | r d j | | � n d } | r3 d j | � n d } d j | | � }
| rf d j |
| � }
n t j d |
� i } y t |
| | | | � } WnF t k
r� t j d � � n& t k
r� } t j d | � � n X| S(
u�
List permissions.
:param username: The name of the user to list permissions for.
:type username: str
:param resource: The resource (keyspace or table), if None, permissions for all resources are listed.
:type resource: str
:param resource_type: The resource_type (keyspace or table), defaults to 'keyspace'.
:type resource_type: str
:param permission: A permission name (e.g. select), if None, all permissions are listed.
:type permission: str
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return: Dictionary of permissions.
:rtype: dict
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.list_permissions
salt 'minion1' cassandra_cql.list_permissions username=joe resource=test_keyspace permission=select
salt 'minion1' cassandra_cql.list_permissions username=joe resource=test_table resource_type=table permission=select contact_points=minion1
u {0} {1}u
all keyspacesu {0} permissionu all permissionsu list {0} on {1}u
{0} of {1}u. Attempting to list permissions with query '%s'u Could not list permissions.u. Unexpected error while listing permissions: %s( R R R R^ R RD R (
R. t resourcet
resource_typet
permissionR= R0 R> R? t keyspace_cqlt permission_cqlRR RS R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt list_permissionsu s #
c C@ s� | r d j | � n d } | r3 d j | | � n d } d j | | | � }
t j d |
� y t |
| | | | � WnF t k
r� t j d � � n& t k
r� } t j d | � � n Xt S( uz
Grant permissions to a user.
:param username: The name of the user to grant permissions to.
:type username: str
:param resource: The resource (keyspace or table), if None, permissions for all resources are granted.
:type resource: str
:param resource_type: The resource_type (keyspace or table), defaults to 'keyspace'.
:type resource_type: str
:param permission: A permission name (e.g. select), if None, all permissions are granted.
:type permission: str
:param contact_points: The Cassandra cluster addresses, can either be a string or a list of IPs.
:type contact_points: str | list[str]
:param cql_user: The Cassandra user if authentication is turned on.
:type cql_user: str
:param cql_pass: The Cassandra user password if authentication is turned on.
:type cql_pass: str
:param port: The Cassandra cluster port, defaults to None.
:type port: int
:return:
:rtype:
CLI Example:
.. code-block:: bash
salt 'minion1' cassandra_cql.grant_permission
salt 'minion1' cassandra_cql.grant_permission username=joe resource=test_keyspace permission=select
salt 'minion1' cassandra_cql.grant_permission username=joe resource=test_table resource_type=table permission=select contact_points=minion1
u grant {0}u grant all permissionsu
on {0} {1}u on all keyspacesu {0} {1} to {2}u/ Attempting to grant permissions with query '%s'u Could not grant permissions.u/ Unexpected error while granting permissions: %s( R R R R^ R RD R R9 ( R. R� R� R� R= R0 R> R? R� t resource_cqlRR R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt grant_permission� s #
(8 t __doc__t
__future__R R R t loggingRH R' t salt.utils.jsonRq t salt.exceptionsR t salt.extR t salt.ext.six.movesR t salt.utils.versionsR# t getLoggert __name__R R R R
t cassandra.clusterR R t cassandra.connectionR R R
t cassandra.authR t cassandra.queryR R9 t ImportErrorR R R" R! R- RC R^ Ri RG Rj Rk Rn Ro R| R} R~ R� R� R� ( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/cassandra_cql.pyt <module>Q sZ
# SPc'2*2* D('19
Mini Shell