Re: COPY enhancements

Josh,
> BTW, some of the questions were for -hackers in general to give
> feedback. Don't take just my responses as final "what you have to do";
> other contributors will have opinions, some of which will be more
> informed than mine.
>
Understood.
>>> A) Why would someone want to turn error_logging on, but leave
>>> error_logging_skip_tuples off? The pg_log already logs errors which
>>> copy throws by default.
>>>
>>>
>> When error_logging is on and skip_tuples is off, errors are logged in
>> the error table. If skip_tuples is on, tuples are not logged in the
>> error table.
>>
>
> Although if you're not skipping tuples, presumably only the first error
> is logged, yes? At that point, COPY would stop.
>
No, when error_logging is on, COPY never stops. If skip_tuples is on,
the faulty tuples are just ignored and not logged, if it is off (it does
not skip) it logs every faulty tuple in the error table and continues
until the end. If error_logging is off, COPY stops on the first error
and aborts.
>>> B) As I mentioned earlier, we'll want to provide the option of logging
>>> to a file instead of to a table. That's not a reason to reject this
>>> patch, but probably a TODO for 8.5.
>>>
>>>
>> Ok but what should be the format of that file?
>>
>
> I'd say a CSV version of the table you have is the simplest way to go.
>
Ok.
>>> C) Are we sure we want to handle this via GUCs rather than extensions to
>>> COPY syntax? It seems like fairly often users would want to log
>>> different COPY sources to different tables/files.
>>>
>>>
>> I agree that new COPY options could be easier to use, the implementation
>> is just more complex. However, the labels allows you to select the
>> tuples related to specific COPY commands.
>>
>
> Yes, and GUCs allow users to retrofit this approach onto existing
> infrastructure without changing their COPY commands. So there's
> advantages and disadvantages. My question was really for the -hackers
> at large: is this the design we want? Or, more directly, is the GUC
> approach anathema to anyone?
>
As it is a new feature, users will either have to add the proper set
commands or modify their COPY commands. Both ways look good to me.
>>> E) What is error_logging_tuple_label for? You don't explain/give
>>> examples. And how is error_logging_tuple_partition_key used?
>>>
>>>
>> We use the label and partition key in Aster products to easily retrieve
>> which COPY command on which partition did generate the bad tuples. By
>> default, the tuple_label contains the COPY command that was executed
>> (see example on Wiki) and the key contains the index of the tuple in the
>> source file (see example on Wiki).
>>
>
> Ah, ok, let me suggest a modified table format then (btw, the table
> format you give doesn't match your examples):
>
The order of the columns does not matter, just the name.
> CREATE TABLE pg_copy_errors(
> session_id TEXT -- session id from PostgreSQL
> tupletimestamp TIMESTAMP WITH TIME ZONE,
> targettable TEXT, -- table being copied to
> errmessage TEXT, -- full error message encountered
> sqlerrcode CHAR(5), -- sql error code
> statement TEXT, -- the full copy statement which failed
> label TEXT, -- optional user-supplied label
> rawdata BYTEA, -- the failed data
> constraint pg_copy_errors_pk primary key (session_id, tupletimestamp,
> targettable)
> );
>
> .. the label would be supplied as copy_logging_label.
>
> This would require you to collect the session_id, of course. Or the
> pid, or something else. But, the table as you laid it out has no
> natural key, which is a problem for debugging. Also, see discussion below.
>
> I still don't understand how error_logging_tuple_partition_key is used.
> Please give more explicit examples.
>
I am not really sure why you need a natural key.
By default, the partition_key contains the index of the faulty entry and
label the copy command. This could be your key.
If you look at the example at
http://wiki.postgresql.org/wiki/Error_logging_in_COPY, input_file.txt
has 5 rows out of which only 1 and 5 are correct (2, 3 and 4 are bad).
The key indicates the row that caused the problem (2, 3, 4) and label
contains the full COPY statement. I am not sure to understand what the
pid or session_id would bring in that scenario.

>>> G) We should probably have a default for error_logging_table_name, such
>>> as pg_copy_errors. Does that table get automatically created if it
>>> doesn't exist?
>>>
>>>
>> Yes, as indicated on the wiki the table is created automatically (see
>> config variable section).
>>
>
> As long as you use CREATE IF NOT EXISTS, that should work ok.
>
Actually the code checks if the table exists with a try_heap_openrv and
creates the table if it fails.
>>> H) Finally, one request of the TODO is some way to halt import after a
>>> specified number of bad tuples because it probably means you have the
>>> wrong file or wrong table. Do we still want that?
>>>
>>>
>> We can still do that. It can be another GUC variable or an option to
>> COPY. If the COPY command fails, everything gets rolled back (data in
>> the destination table and error table). That would be harder to
>> implement with a file (the rollback part).
>>
>
> With a logging file, you wouldn't worry about rollback. You'd just log
> a statement to the file that it was rolled back.
>
Ok.
> I) Aster's current implementation has the advantage of being able to log
> to any user-defined table, giving users the flexibility to log different
> COPYs to different tables, or even put them on various tablespaces. Is
> that what we want, though? Clearly it would make things simpler for
> most (but not all) users to have just a canonical pg_copy_errors table
> which was in pg_catalog. It would also presumably remove some code from
> the patch (usually a good thing) What do people think?
>
The code that would be removed would just be the table creation and the
GUC variable for the table name. That would not remove much code.
> J) One option I think we need if we're going to support logging to "any
> defined logging table" is the option to make that table a temporary table.
>
Actually you can create the table beforehand (check unit tests for an
example) and so it is possible to make it a temporary table if you want
(I would just have to test it, I did not try it yet).
>>> O) Is this capable of dealing with partitioning by more than one column,
>>> or by an expression?
>>>
>>>
>> Yes, we just use a brute force technique where we try all child tables
>> 1-by-1 and rely on the existing Postgres constraint checking mechanism
>> (no new or duplicated code there).
>>
>
> Sounds disastrous performance-wise. There's no easy way to test the
> expression without attempting an actual insert?
>
An option that was proposed at PGCon by someone in the audience (sorry I
don't remember who), was to build a query plan and find out from there
which child table should get the tuple. It will be disastrous
performance-wise if you always have misses and need to check a lot of
constraints (we can always build a worst case scenario test). However,
in my tests, even with completely random data, routing is faster than a
script doing sorting in multiple files + manual inserts in each child
table. In practice, even a small cache size usually works very well as
soon as you have enough locality in your source data.
The problem is that faulty tuples will have to check all constraints to
figure out that there is no child table for them. Note that if you have
a deep tree hierarchy, you don't necessarily have to insert at the top
of the tree, you can start anywhere down the tree.
Once we have the full partitioning support (in 8.5?), we can probably
re-use some of their mechanism to route directly the tuple to the right
child.

Thanks for your great feedback,
Emmanuel

--
Emmanuel Cecchet
Aster Data Systems
Web: http://www.asterdata.com