Add document

Author: zhuqi-lucas

datafusion/core/src/datasource/file_format/parquet.rs

@@ -385,7 +385,7 @@ impl FileFormat for ParquetFormat {
         };
 
         let schema = if self.force_view_types() {
-            Arc::new(transform_schema_to_view(&schema))
+            Arc::new(transform_schema_to_view(schema.as_ref()))
         } else {
             schema
         };

datafusion/datasource/src/file_format.rs

@@ -73,7 +73,10 @@ pub trait FileFormat: Send + Sync + fmt::Debug {
         objects: &[ObjectMeta],
     ) -> Result<SchemaRef>;
 
-    /// Transform the schema of the provided object. The cost and accuracy of the
+    /// Transform the schema of the provided object. For example for parquet files:
+    /// 1. Transform a schema so that any binary types are strings
+    /// 2. Transform a schema to use view types for Utf8 and Binary
+    /// Other file formats may have other transformations, but currently only for parquet
     async fn transform_schema(&self, schema: SchemaRef) -> Result<SchemaRef>;
 
     /// Infer the statistics for the provided object. The cost and accuracy of the