You are viewing a plain text version of this content. The canonical link for it is here.
Posted to reviews@spark.apache.org by GitBox <gi...@apache.org> on 2019/12/05 19:07:26 UTC
[GitHub] [spark] dongjoon-hyun commented on a change in pull request #26750:
[SPARK-28948][SQL] Support passing all Table metadata in TableProvider
dongjoon-hyun 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_r354494583
##########
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:
So, the main idea of this PR is to remove the case-insensitive requirements from the original java `TableProvider` DSv2 design?
----------------------------------------------------------------
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:
users@infra.apache.org
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org