zeroshade commented on code in PR #3607:
URL: https://github.com/apache/arrow-adbc/pull/3607#discussion_r2461762081
##########
c/include/arrow-adbc/adbc.h:
##########
@@ -1665,6 +1869,49 @@ AdbcStatusCode AdbcConnectionGetObjects(struct
AdbcConnection* connection, int d
struct ArrowArrayStream* out,
struct AdbcError* error);
+/// \brief Asynchronous version of AdbcConnectionGetObjects to retrieve
+/// metadata about catalogs, database schemas, tables, and columns.
+///
+/// See documentation for AdbcConnectionGetObjects for details about
+/// the result schema.
+///
+/// This AdbcConnection must outlive the populated
ArrowAsyncDeviceStreamHandler.
+///
+/// \since ADBC API revision 1.2.0
+///
+/// \param[in] connection The database connection
+/// \param[in] depth The level of nesting to display. If 0, display
+/// all levels. If 1, display only catalogs (i.e. catalog_schemas
+/// will be null). If 2, display only catalogs and schemas
+/// (i.e. db_schema_tables will be null), and so on.
+/// \param[in] catalog Only show tables in the given catalog. If NULL,
+/// do not filter by catalog. If an empty string, only show tables
+/// without a catalog. May be a search pattern (see section
+/// documentation).
+/// \param[in] db_schema Only show tables in the given database schema. If
+/// NULL, do not filter by database schema. If an empty string, only show
+/// tables without a database schema. May be a search pattern (see section
+/// documentation).
+/// \param[in] table_name Only show tables with the given name. If NULL, do not
+/// filter by name. May be a search pattern (see section documentation).
+/// \param[in] table_type Only show tables matching one of the given table
+/// types. If NULL, show tables of any type. Valid table types can be fetched
+/// from GetTableTypes. Terminate the list with a NULL entry.
+/// \param[in] column_name Only show columns with the given name. If
+/// NULL, do not filter by name. May be a search pattern (see
+/// section documentation).
+/// \param[in] handler The async stream handler.
Review Comment:
Not really, the consumer populates the callbacks and then passes it to the
async functions as input for the producing function to kick off and call. See
the [sequence
diagram](https://arrow.apache.org/docs/format/CDeviceDataInterface.html#possible-sequence-diagram)
in the docs
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
