README.md in fluent-plugin-bigquery-2.3.0 vs README.md in fluent-plugin-bigquery-3.0.0
- old
+ new
@@ -1,15 +1,7 @@
# fluent-plugin-bigquery
-## Notice
-
-We will transfer fluent-plugin-bigquery repository to [fluent-plugins-nursery](https://github.com/fluent-plugins-nursery) organization.
-It does not change maintenance plan.
-The main purpose is that it solves mismatch between maintainers and current organization.
-
----
-
[Fluentd](http://fluentd.org) output plugin to load/insert data into Google BigQuery.
- **Plugin type**: Output
* insert data over streaming inserts
@@ -29,10 +21,11 @@
| plugin version | fluentd version | ruby version |
| :----------- | :----------- | :----------- |
| v0.4.x | 0.12.x | 2.0 or later |
| v1.x.x | 0.14.x or later | 2.2 or later |
| v2.x.x | 0.14.x or later | 2.3 or later |
+| v3.x.x | 1.x or later | 2.7 or later |
## With docker image
If you use official alpine based fluentd docker image (https://github.com/fluent/fluentd-docker-image),
You need to install `bigdecimal` gem on your own dockerfile.
Because alpine based image has only minimal ruby environment in order to reduce image size.
@@ -386,30 +379,32 @@
`table` and `tables` options accept [Time#strftime](http://ruby-doc.org/core-1.9.3/Time.html#method-i-strftime)
format to construct table ids.
Table ids are formatted at runtime
using the chunk key time.
-see. http://docs.fluentd.org/v0.14/articles/output-plugin-overview
+see. https://docs.fluentd.org/configuration/buffer-section
For example, with the configuration below,
-data is inserted into tables `accesslog_2014_08`, `accesslog_2014_09` and so on.
+data is inserted into tables `accesslog_2014_08_02`, `accesslog_2014_08_03` and so on.
```apache
<match dummy>
@type bigquery_insert
...
project yourproject_id
dataset yourdataset_id
- table accesslog_%Y_%m
+ table accesslog_%Y_%m_%d
<buffer time>
timekey 1d
</buffer>
...
</match>
```
+
+**NOTE: In current fluentd (v1.15.x), The maximum unit supported by strftime formatting is the granularity of days**
#### record attribute formatting
The format can be suffixed with attribute name.
__CAUTION: format is different with previous version__