Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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) bisLOG_TRACE (6), hatte der Amazon Athena ODBC 2.x-Treiber ursprünglich nur zwei Werte: 0 (deaktiviert) und 1 (aktiviert). Ab Version 2.0.6.0 unterstützt der Treiber jetzt detailliertere Protokollierungsebenen mit erweiterten Protokollierungsfunktionen:
OFF- Die Protokollierung ist deaktiviertERROR- Es werden nur Fehlermeldungen protokolliertWARN- Warnmeldungen und Fehler werden protokolliertINFO- Informationsmeldungen, Warnungen und Fehler werden protokolliertDEBUG- Detaillierte Debug-Informationen sowie alle Meldungen auf niedrigerer Ebene werden protokolliertTRACE- Detaillierteste Protokollierungsebene, umfasst alle Meldungen
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 |
OFF |
| Mögliche Werte | 0-6 |
Für Versionen vor 2.0.6.0: Für Version 2.0.6.0 und höher: |
| Beispiel für Verbindungszeichenfolgen | LogLevel=6; |
LogLevel=INFO; |
Anmerkung
In Version 2.0.6.0 und höher wurde das Logging-Framework optimiert, um Betriebsverzögerungen und die übermäßige Generierung von Protokolldateien zu reduzieren und gleichzeitig detailliertere Diagnoseinformationen über diese detaillierten Protokollebenen bereitzustellen. Jede Ebene umfasst alle Meldungen der darunterliegenden Ebenen.
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-Treiberverbindung testen, ruft der Treiber die GetWorkGroupAthena-API-Aktion 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.
