add comment for usage of Result Mode, and fix the parameter.

Author: muroon

README.md

@@ -55,6 +55,7 @@ Note
 - DL and GZIP DL Mode are used only in the Select statement.
   - Other statements automatically use API mode under DL or GZIP DL Mode.
 - Detailed explanation is described [here](doc/result_mode.md).
+- [Usages of Result Mode](doc/result_mode.md#usages).
 
 ## Testing
 

doc/result_mode.md

@@ -64,3 +64,31 @@ It is a comparison of the time taken from executing the query in the actual resu
 I think the following trends can be said.
 - DL mode and API mode are effective for a small number of cases
 - GZIP DL mode is very effective for a large number of cases
+
+## Usages
+
+### Setting in Configuration
+
+```
+# DL Mode
+db, err := sql.Open("athena", "db=xxxx&output_location=s3://xxxxxxx&region=xxxxxx&result_mode=dl")
+
+# GZIP DL Mode
+db, err := sql.Open("athena", "db=xxxx&output_location=s3://xxxxxxx&region=xxxxxx&result_mode=gzip")
+```
+
+### Setting in Context
+
+You can change the Result Mode for each SQL.
+Settings in context override Configuration settings.
+
+```
+# API Mode
+ctx = SetAPIMode(ctx)
+
+# DL Mode
+ctx = SetDLMode(ctx)
+
+# GZIP DL Mode
+ctx = SetGzipDLMode(ctx)
+```

driver.go

@@ -176,7 +176,7 @@ func configFromConnectionString(connStr string) (*Config, error) {
 	}
 
 	cfg.ResultMode = ResultModeAPI
-	modeValue := strings.ToLower(args.Get("mode"))
+	modeValue := strings.ToLower(args.Get("result_mode"))
 	switch {
 	case modeValue == "dl" || modeValue == "download":
 		cfg.ResultMode = ResultModeDL