Migration zum ODBC-Treiber 2.x
Da die meisten Athena-ODBC-2.x-Verbindungsparameter abwärtskompatibel mit dem ODBC-1.x-Treiber sind, können Sie den größten Teil Ihrer vorhandenen Verbindungszeichenfolge mit dem Athena-ODBC-2.x-Treiber wiederverwenden. Die folgenden Verbindungsparameter müssen jedoch geändert werden.
Protokollebene
Während der aktuelle ODBC-Treiber eine Reihe verfügbarer Protokollierungsoptionen bietet, angefangen bei LOG_OFF (0) bis LOG_TRACE (6), hat der ODBC-Treiber von Amazon Athena nur zwei Werte: 0 (deaktiviert) und 1 (aktiviert).
Weitere Hinweise zur Protokollierung des ODBC-2.x-Treibers finden Sie unter Protokollierungsoptionen.
| ODBC-1.x-Treiber | ODBC-2.x-Treiber | |
|---|---|---|
| Name der Verbindungszeichenfolge | LogLevel |
LogLevel |
| Parametertyp | Optional | Optional |
| Standardwert | 0 |
0 |
| Mögliche Werte | 0-6 |
0,1 |
| Beispiel für Verbindungszeichenfolgen | LogLevel=6; |
LogLevel=1; |
MetadataRetrievalMethod
Der aktuelle ODBC-Treiber bietet mehrere Optionen zum Abrufen der Metadaten von Athena. Der ODBC-Treiber von Amazon Athena veraltet und MetadataRetrievalMethod verwendet immer die Amazon-Athena-API, um Metadaten zu extrahieren.
Athena führt die Kennzeichnung QueryExternalCatalogs für die Abfrage externer Kataloge ein. Um externe Kataloge mit dem aktuellen ODBC-Treiber abzufragen, setzen Sie MetadataRetrievalMethod auf ProxyAPI. Um externe Kataloge mit dem ODBC-Treiber von Athena abzufragen, setzen Sie QueryExternalCatalogs auf 1.
| ODBC-1.x-Treiber | ODBC-2.x-Treiber | |
|---|---|---|
| Name der Verbindungszeichenfolge | MetadataRetrievalMethod |
QueryExternalCatalogs |
| Parametertyp | Optional | Optional |
| Standardwert | Auto |
0 |
| Mögliche Werte | Auto, AWS Glue, ProxyAPI,
Query |
0,1 |
| Beispiel für Verbindungszeichenfolgen | MetadataRetrievalMethod=ProxyAPI; |
QueryExternalCatalogs=1; |
Verbindungstest
Wenn Sie eine ODBC-1.x-Treiberverbindung testen, führt der Treiber eine SELECT 1-Abfrage aus, die zwei Dateien in Ihrem Amazon-S3-Bucket generiert: eine für die Ergebnismenge und eine für die Metadaten. Die Testverbindung wird gemäß den Amazon-Athena-Preisrichtlinien
Wenn Sie eine ODBC-2.x-Treiber-Verbindung testen, ruft der Treiber die API-Aktion GetWorkGroup von Athena auf. Der Aufruf verwendet den Authentifizierungstyp und den entsprechenden Anbieter von Anmeldeinformationen, den Sie zum Abrufen der Anmeldeinformationen angegeben haben. Der Verbindungstest ist kostenlos, wenn Sie den ODBC-2.x-Treiber verwenden, und der Test generiert keine Abfrageergebnisse in Ihrem Amazon-S3-Bucket.
