feat: add "ANCESTOR TABLE" table type(#3194)

[peixingzhe]

All Submissions:

• Have you followed the guidelines in our Contributing document?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?

New Feature Submissions:

1. Does your submission pass tests?
2. Does ./gradlew styleCheck pass ?
3. Have you added your new test classes to an existing test suite in alphabetical order?

[davecramer]

This will require documentation and tests

[peixingzhe]

This will require documentation and tests

Can you give some examples of documentation and test code?

[davecramer]

This will require documentation and tests

Can you give some examples of documentation and test code?

https://github.com/pgjdbc/pgjdbc/blob/master/pgjdbc/src/test/java/org/postgresql/test/jdbc2/DatabaseMetaDataTest.java#L1194

We should test for ANCESTOR TABLE and PARTITIONED TABLES

As for docs since both of these are not standard we should add this to https://github.com/pgjdbc/pgjdbc/blob/master/docs/content/documentation/use.md somewhere

[peixingzhe]

This will require documentation and tests

Can you give some examples of documentation and test code?

https://github.com/pgjdbc/pgjdbc/blob/master/pgjdbc/src/test/java/org/postgresql/test/jdbc2/DatabaseMetaDataTest.java#L1194

We should test for ANCESTOR TABLE and PARTITIONED TABLES

As for docs since both of these are not standard we should add this to https://github.com/pgjdbc/pgjdbc/blob/master/docs/content/documentation/use.md somewhere

Ok, thank you , i will add these.

[davecramer]

I don't think we test for PARTITIONED TABLE either. Can you add that test as well?

[peixingzhe]

@davecramer Hi, I add some test code reference to the #1708 ,but I didn't find any document about "PARTITIONED TABLE", how
do I add it？

[peixingzhe]

I don't think we test for PARTITIONED TABLE either. Can you add that test as well?

Looks like we already have the test code for PARTITIONED TABLE

pgjdbc/pgjdbc/src/test/java/org/postgresql/test/jdbc2/DatabaseMetaDataTest.java

Line 1545 in 4e710d5

void partitionedTables(BinaryMode binaryMode) throws SQLException {

[peixingzhe]

@davecramer hi，do I need to do anything else?

[davecramer]

Us try with resources, please

[peixingzhe]

Because I need to delete the test table in the finally code block, is it necessary to use try-with-resource here?

[davecramer]

@davecramer hi，do I need to do anything else?

Yes, please add docs here https://github.com/pgjdbc/pgjdbc/blob/master/docs/content/documentation/use.md

[peixingzhe]

I will and the following document at the bottom of this document. What do you think?

Retrieve Database Metadata

In the standard JDBC API, we can get the database metadata from the connection, and through this metadata object, we can get the database table type, table collection, and so on.

As an extension, PostgreSQL® JDBC Driver provides PARTITIONED TABLE, ANCESTOR TABLE and other table type extensions. Using these two extensions, we can only obtain the table set of the corresponding type from the database.