cloud-fan commented on a change in pull request #26750: [SPARK-28948][SQL]
Support passing all Table metadata in TableProvider
URL: https://github.com/apache/spark/pull/26750#discussion_r354703197
##########
File path:
sql/catalyst/src/main/java/org/apache/spark/sql/connector/catalog/TableProvider.java
##########
@@ -36,26 +38,47 @@
public interface TableProvider {
/**
- * Return a {@link Table} instance to do read/write with user-specified
options.
+ * Return a {@link Table} instance with specified table properties to do
read/write.
+ * Implementations should infer the table schema and partitioning.
+ *
+ * @param properties The specified table properties. It's case preserving
(contains exactly what
+ * users specified) and implementations are free to use it
case sensitively or
+ * insensitively. It should be able to identify a table,
e.g. file path, Kafka
+ * topic name, etc.
+ */
+ Table getTable(Map<String, String> properties);
+
+ /**
+ * Return a {@link Table} instance with specified table schema and
properties to do read/write.
+ * Implementations should infer the table partitioning.
+ *
+ * @param schema The specified schema.
+ * @param properties The specified table properties. It's case preserving
(contains exactly what
+ * users specified) and implementations are free to use it
case sensitively or
+ * insensitively. It should be able to identify a table,
e.g. file path, Kafka
+ * topic name, etc.
*
- * @param options the user-specified options that can identify a table, e.g.
file path, Kafka
- * topic name, etc. It's an immutable case-insensitive
string-to-string map.
+ * @throws IllegalArgumentException if the specified schema does not match
the actual table
+ * schema.
*/
- Table getTable(CaseInsensitiveStringMap options);
+ Table getTable(StructType schema, Map<String, String> properties);
Review comment:
no, the main idea is to add a new overload method to accept user-specified
partitioning. Since we need to change the API, we change the option type as
well, see https://github.com/apache/spark/pull/26750/files#r354692676
----------------------------------------------------------------
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.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
