https://github.com/mrotteveel/ext-table-gen

Firebird External Table Genertor or ext-table-gen is a tool to convert RFC 4180 CSV files and custom CSV files to Firebird external table files
https://github.com/mrotteveel/ext-table-gen

csv external-table firebird

Last synced: 2 months ago
JSON representation

Firebird External Table Genertor or ext-table-gen is a tool to convert RFC 4180 CSV files and custom CSV files to Firebird external table files

• Host: GitHub
• URL: https://github.com/mrotteveel/ext-table-gen
• Owner: mrotteveel
• Created: 2023-06-23T12:39:44.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-29T17:06:22.000Z (3 months ago)
• Last Synced: 2024-10-29T18:32:38.695Z (3 months ago)
• Topics: csv, external-table, firebird
• Language: Java
• Homepage: https://mrotteveel.github.io/ext-table-gen/
• Size: 658 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.adoc
  • Funding: .github/FUNDING.yml
  • License: LICENSES/Apache-2.0.txt

Awesome Lists containing this project

README

        
// SPDX-FileCopyrightText: 2023 Mark Rotteveel

// SPDX-License-Identifier: Apache-2.0

= ext-table-gen: Firebird External Table Generator

The "`Firebird External Table Generator`" or _ext-table-gen_ is a commandline tool to convert https://www.rfc-editor.org/rfc/rfc4180[RFC 4180^] CSV files and CSV files with custom formats to https://www.firebirdsql.org/[Firebird^] external tables (a binary format for Firebird external table data).

External tables are a good way for bulk-loading data into Firebird.

Unfortunately, external tables use a fixed-width _binary_ formatfootnote:[The format is essentially the in-memory layout of rows which Firebird also uses internally], and not a (more) standard format like CSV.

It is not always easy to create an appropriate external table file, and this is where _ext-table-gen_ can be used.

At a high level, _ext-table-gen_ provides the following features:

* Derive a `CHAR`-based external table definition (i.e. a `CREATE TABLE` statement and a configuration for _ext-table-gen_) from a CSV file

* Transform a CSV file to an external table file (either based on the CSV file itself, or based on a configuration file)

By default, _ext-table-gen_ derives tables with only `CHAR` columns.

This makes the generated file essentially a fixed-width text format.

However, you can modify the configuration file to make _ext-table-gen_ generate columns of different types, in which case the file becomes a binary format.

_ext-table-gen_ supports the following types of columns:

* String types:

** `char`

* Integral number types:

** `smallint`

** `integer`

** `bigint`

** `int128`

* Exact numeric types (fixed point):

** `numeric`

** `decimal`

* Datetime types:

** `date`

** `time` (without time zone)

** `timestamp` (without time zone)

The project is hosted on GitHub: https://github.com/mrotteveel/ext-table-gen[^].

== Documentation

Documentation of the latest tagged release can be found on: https://mrotteveel.github.io/ext-table-gen/[^]

SPDX-License-Identifier: Apache-2.0