This repository has been archived by the owner on Aug 4, 2020. It is now read-only.
/
CHANGES
270 lines (210 loc) · 11.6 KB
/
CHANGES
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
Changes in Version 1.1.0
This release adds compatibility with Cassandra 0.8, including support for
counters and key_validation_class. This release is backwards-compatible with
Cassandra 0.7, and can support running against a mixed cluster of both
Cassandra 0.7 and 0.8.
Changes related to Cassandra 0.8
* Addition of COUNTER_COLUMN_TYPE to system_manager.
* Several new column family attributes, including key_validation_class,
replicate_on_write, merge_shards_chance, row_cache_provider, and key_alias.
* The new ColumnFamily.add() and ColumnFamily.remove_counter() methods.
* Support for counters in pycassa.batch and ColumnFamily.batch_insert().
* Autopacking of keys based on key_validation_class.
Other Features
* ColumnFamily.multiget() now has a buffer_size parameter
* ColumnFamily.multiget_count() now returns rows in the order that the
keys were passed in, similar to how multiget() behaves. It also uses
the dict_class attribute for the containing class instead of always
using a dict.
* Autpacking behavior is now more transparent and configurable, allowing
the user to get functionality similar to the CLI’s assume command, whereby
items are packed and unpacked as though they were a certain data type,
even if Cassandra does not use a matching comparator type or validation
class. This behavior can be controlled through the following attributes:
- ColumnFamily.column_name_class
- ColumnFamily.super_column_name_class
- ColumnFamily.key_validation_class
- ColumnFamily.default_validation_class
- ColumnFamily.column_validators
* A ColumnFamily may reload its schema to handle changes in validation
classes with ColumnFamily.load_schema().
Bug Fixes
There were several related issues with overlow in ConnectionPool:
* Connection failures when a ConnectionPool was in a state of overflow
would not result in adjustment of the overflow counter, eventually
leading the ConnectionPool to refuse to create new connections.
* Settings of -1 for ConnectionPool.overflow erroneously caused overflow
to be disabled.
* If overflow was enabled in conjunction with prefill being disabled,
the effective overflow limit was raised to max_overflow + pool_size.
Other
* Overflow is now disabled by default in ConnectionPool.
* ColumnFamilyMap now sets the underlying ColumnFamily‘s
autopack_names and autopack_values attributes to False upon construction.
* Documentation and tests will no longer be included in the
packaged tarballs.
Removed Deprecated Items
The following deprecated items have been removed:
* ColumnFamilyMap.get_count()
* The instance parameter from ColumnFamilyMap.get_indexed_slices()
* The Int64 Column type.
* SystemManager.get_keyspace_description()
Deprecated
Athough not technically deprecated, most ColumnFamily constructor
arguments should instead be set by setting the corresponding
attribute on the ColumnFamily after construction. However, all
previous constructor arguments will continue to be supported if
passed as keyword arguments.
Changes in Version 1.0.8
* Pack IndexExpression values in get_indexed_slices() that are supplied
through the IndexClause instead of just the instance parameter.
* Column names and values which use Cassandra’s IntegerType are unpacked
as though they are in a BigInteger-like format. This is (backwards)
compatible with the format that pycassa uses to pack IntegerType data.
This fixes an incompatibility with the format that cassandra-cli and
other clients use to pack IntegerType data.
* Restore Python 2.5 compatibility that was broken through out of order
keyword arguments in ConnectionWrapper.
* Pack column_start and column_finish arguments in ColumnFamily *get*()
methods when the super_column parameter is used.
* Issue a DeprecationWarning when a method, parameter, or class that has
been deprecated is used. Most of these have been deprecated for several
releases, but no warnings were issued until now.
* Deprecations are now split into separate sections for each release in the changelog.
Deprecated in Version 1.0.8
* The instance parameter of ColumnFamilyMap.get_indexed_slices()
Changes in Version 1.0.7
* Catch KeyError in pycassa.columnfamily.ColumnFamily.multiget() empty row
removal. If the same non-existent key was passed multiple times, a
KeyError was raised when trying to remove it from the OrderedDictionary
after the first removal. The KeyError is caught and ignored now.
* Handle connection failures during retries. When a connection fails, it
tries to create a new connection to replace itself. Exceptions during
this process were not properly handled; they are now handled and count
towards the retry count for the current operation.
* Close connection when a MaximumRetryException is raised. Normally a
connection is closed when an operation it is performing fails, but this
was not happening for the final failure that triggers the
MaximumRetryException.
Changes in Version 1.0.6
* Add EOFError to the list of exceptions that cause a connection swap and
retry
* Improved autopacking efficiency for AsciiType, UTF8Type, and BytesType
* Preserve sub-second timestamp precision in datetime arguments for
insertion or slice bounds where a TimeUUID is expected. Previously,
precision below a second was lost.
* In a MaximumRetryException‘s message, include details about the last
Exception that caused the MaximumRetryException to be raised
* pycassa.pool.ConnectionPool.status() now always reports a non-negative
overflow; 0 is now used when there is not currently any overflow
* Created pycassa.types.Long as a replacement for pycassa.types.Int64.
Long uses big-endian encoding, which is compatible with Cassandra’s LongType,
while Int64 used little-endian encoding.
Deprecated in Version 1.0.6
* pycassa.types.Int64 has been deprecated in favor of pycassa.types.Long
Changes in Version 1.0.5
* Assume port 9160 if only a hostname is given
* Remove super_column param from pycassa.columnfamily.ColumnFamily.get_indexed_slices()
* Enable failover on functions that previously lacked it
* Increase base backoff time to 0.01 seconds
* Add a timeout parameter to pycassa.system_manager.SystemManger
* Return timestamp on single-column inserts
Changes in Version 1.0.4
* Fixed threadlocal issues that broke multithreading
* Fix bug in pycassa.columnfamily.ColumnFamily.remove() when a super_column
argument is supplied
* Fix minor PoolLogger logging bugs
* Added pycassa.system_manager.SystemManager.describe_partitioner()
* Added pycassa.system_manager.SystemManager.describe_snitch()
* Added pycassa.system_manager.SystemManager.get_keyspace_properties()
* Moved pycassa.system_manager.SystemManager.describe_keyspace() and
pycassa.system_manager.SystemManager.describe_column_family() to
pycassaShell describe_keyspace() and describe_column_family()
Deprecated in Version 1.0.4
* Renamed pycassa.system_manager.SystemManager.get_keyspace_description()
to pycassa.system_manager.SystemManager.get_keyspace_column_families()
and deprecated the previous name
Changes in Version 1.0.3
* Fixed supercolumn slice bug in get()
* pycassaShell now runs scripts with execfile to allow for multiline statements
* 2.4 compatability fixes
Changes in Version 1.0.2
* Failover handles a greater set of potential failures
* pycassaShell now loads/reloads pycassa.columnfamily.ColumnFamily instances when the underlying column family is created or updated
* Added an option to pycassaShell to run a script after startup
* Added pycassa.system_manager.SystemManager.list_keyspaces()
Changes in Version 1.0.1
* Allow pycassaShell to be run without specifying a keyspace
* Added pycassa.system_manager.SystemManager.describe_schema_versions()
Changes in Version 1.0.0
* Created the SystemManager class to allow for keyspace, column family, and
index creation, modification, and deletion. These operations are no longer
provided by a Connection class.
* Updated pycassaShell to use the SystemManager class
* Improved retry behavior, including exponential backoff and proper resetting
of the retry attempt counter
* Condensed connection pooling classes into only pycassa.pool.ConnectionPool
to provide a simpler API
* Changed pycassa.connection.connect() to return a connection pool
* Use more performant Thrift API methods for insert() and get() where possible
* Bundled OrderedDict and set it as the default dictionary class for column families
* Provide better TypeError feedback when columns are the wrong type
* Use Thrift API 19.4.0
Deprecated in Version 1.0.0
* ColumnFamilyMap.get_count() has been deprecated. Use
ColumnFamily.get_count() instead.
Changes in Version 0.5.4
* Allow for more backward and forward compatibility
* Mark a server as being down more quickly in Connection
Changes in Version 0.5.3
* Added PooledColumnFamily, which makes it easy to use connection pooling
automatically with a ColumnFamily.
Changes in Version 0.5.2
* Support for adding/updating/dropping Keyspaces and CFs in pycassa.connection.Connection
* get_range() optimization and more configurable batch size
* batch get_indexed_slices() similar to get_range()
* Reorganized pycassa logging
* More efficient packing of data types
* Fix error condition that results in infinite recursion
* Limit pooling retries to only appropriate exceptions
* Use Thrift API 19.3.0
Changes in Version 0.5.1
* Automatically detect if a column family is a standard column family or a super column family
* multiget_count() support
* Allow preservation of key order in multiget() if an ordered dictionary is used
* Convert timestamps to v1 UUIDs where appropriate
* pycassaShell documentation
* Use Thrift API 17.1.0
Changes in Version 0.5.0
* Connection Pooling support: pycassa.pool
* Started moving logging to pycassa.logger
* Use Thrift API 14.0.0
Changes in Version 0.4.3
* Autopack on CF’s default_validation_class
* Use Thrift API 13.0.0
Changes in Version 0.4.2
* Added batch mutations interface: pycassa.batch
* Made bundled thrift-gen code a subpackage of pycassa
* Don’t attempt to reencode already encoded UTF8 strings
Changes in Version 0.4.1
* Added batch_insert()
* Redifined insert() in terms of batch_insert()
* Fixed UTF8 autopacking
* Convert datetime slice args to uuids when appropriate
* Changed how thrift-gen code is bundled
* Assert that the major version of the thrift API is the same on the client
and on the server
* Use Thrift API 12.0.0
Changes in Version 0.4.0
* Added pycassaShell, a simple interactive shell
* Converted the test config from xml to yaml
* fixed overflow error on get_count()
* Only insert columns which exist in the model object
* Make ColumnFamilyMap not ignore the ColumnFamily’s dict_class
* Specify keyspace as argument to connect()
* Add support for framed transport and default to using it
* Added autopacking for column names and values
* Added support for secondary indexes with get_indexed_slices() and
pycassa.index
* Added truncate()
* Use Thrift API 11.0.0