Amazon Athena ODBC Driver2.5.0.0

Amazon Athena ODBC 2.x sürücüsünün bu sürümü, 2.4.0.0 sürümünden bu yana yapılan değişiklikleri içerir. Yükseltme yapmadan önce geriye dönük uyumluluğu bozan değişiklikleri inceleyin. Önceki sürümlerin yok saydığı bağlantı parametresi değerleri artık bağlantının başarısız olmasına neden olur. Geriye dönük uyumluluğu bozan değişiklikler - AuthenticationType doğrulaması – Sürücü artık belgelenen değerlerden biri olmayan herhangi bir AuthenticationType değerini reddeder ve IAM kimlik bilgilerine geri dönmek yerine bağlantıyı HY000 ile başarısız kılar. Default artık Default Credentials için daha kısa bir biçim olarak kabul edilir. Daha fazla bilgi için Authentication options bölümüne bakın. - UseSingleCatalogAndSchema doğrulaması – Sürücü artık UseSingleCatalogAndSchema için yalnızca 0 veya 1 değerlerini kabul eder. Diğer tüm değerler bağlantının HY000 ile başarısız olmasına neden olur. Daha fazla bilgi için Use single catalog and schema bölümüne bakın. - LogLevel doğrulaması – Sürücü artık tanımadığı bir LogLevel değeri için bağlantıyı HY000 ile başarısız kılar ve sürücü genelinde OFF dışında bir LogLevel kullanılması artık LogPath gerektirir. Daha fazla bilgi için Logging options bölümüne bakın. - AWS Glue katalog listeleme hataları bildiriliyor – Çoklu katalog taraması, erişim reddedildi veya varlık bulunamadı dışındaki bir nedenle (örneğin azaltma) AWS Glue kataloglarını listeleyemediğinde, katalog işlevi artık daha kısa bir liste döndürmek yerine HY000 ile başarısız olur ve [AmazonAthena][GlueClientError] ile başlayan bir mesaj verir. Daha fazla bilgi için AWS Glue endpoint override bölümüne bakın. - Tek katalog ve şema modu zorunlu kılındı – UseSingleCatalogAndSchema=1 ile katalog işlevleri artık Athena veya AWS Glue'u çağırmadan yalnızca yapılandırılmış Catalog ve Schema değerlerini döndürür. Bu ayrıca Power BI'ın "cannot convert the value null to type Record" hatasını önler. Her katalog ve şemayı listelemek için UseSingleCatalogAndSchema=0 olarak ayarlayın. Daha fazla bilgi için Use single catalog and schema bölümüne bakın. - SQL_ATTR_METADATA_ID altında katalog arama desenleri devre dışı – Bağlantıda SQL_ATTR_METADATA_ID değerini SQL_TRUE olarak ayarlarsanız, ifadelerindeki katalog işlevi bağımsız değişkenleri artık arama desenleri yerine tanımlayıcı olarak değerlendirilir; bu nedenle joker karakter bağımsız değişkenleri artık eşleşmez. İyileştirmeler - AWS Glue uç noktası geçersiz kılma – Çoklu katalog taramasında kullanılan AWS Glue çağrılarının uç noktasını ayarlamak için GlueEndpointOverride parametresi eklendi. Daha fazla bilgi için AWS Glue endpoint override bölümüne bakın. - İkili sütun uzunluğu – Sürücünün varbinary sütunları için bildirdiği sütun boyutunu ayarlamak üzere BinaryColumnLength parametresi eklendi. Daha fazla bilgi için Binary column length bölümüne bakın. - Bağlantı önbelleğe alma – EnableConnectionCaching parametresi eklendi. 1 olarak ayarlandığında sürücü, bağlandığınızda yaptığı GetWorkGroup çağrısının sonucunu sürücü işlemi başına beş dakika boyunca önbelleğe alır. Daha fazla bilgi için Enable connection caching bölümüne bakın. - IAM profil kimlik bilgileri – IAM Profile kimlik doğrulama eklentisini kullanan bağlantılar artık seçilen profile ait AWS kimlik bilgileri veya yapılandırma dosyası değiştiğinde kimlik bilgilerini yeniden yükler. Daha fazla bilgi için IAM profile bölümüne bakın. - SQLGetInfo eklemeleri – SQL_ODBC_VER, SQL_XOPEN_CLI_YEAR, SQL_ODBC_SAG_CLI_CONFORMANCE ve SQL_CONVERT_WCHAR, SQL_CONVERT_WVARCHAR ve SQL_CONVERT_WLONGVARCHAR dönüştürme maskeleri eklendi. - Sorgu hata mesajları – Bir Athena sorgusu boş bir hata mesajıyla başarısız olduğunda, sürücü artık Athena'nın sorgu için döndürdüğü durum değişikliği nedenini bildirir. - SQLBrowseConnect anahtar sözcükleri – SQLBrowseConnect artık AuthenticationType, AwsProfile, Catalog, Schema, SessionToken ve Workgroup değerlerini isteğe bağlı anahtar sözcükler olarak listeler. - Belirli SQLSTATE'ler – Desteklenmeyen veya bilinmeyen öznitelikler ve SQLGetInfo türleri, SQLDescribeParam ve dönüştürme hataları artık yalnızca SQL_ERROR veya genel bir kod yerine belirli SQLSTATE'ler döndürür. - Bağlantı hatası SQLSTATE'leri – Bağlandığınızda yapılan GetWorkGroup çağrısından kaynaklanan bir bağlantı hatası, kimlik bilgisi hataları için artık 28000, eksik workgroup gibi istek hataları için 08004, ağ ve istek zaman aşımı hataları için 08S01, diğer durumlarda ise 08001 döndürür. - Geniş karakterli katalog meta verileri – UseWCharForStringTypes=1 ile SQLColumns ve katalog sonuç kümeleri artık geniş karakter türlerini ve bayt uzunluklarını bildirir. Daha fazla bilgi için Use WCHAR for string types bölümüne bakın. - Lisans güncellemesi – Sürücü lisansı artık derlenmiş sürücünün ürününüze gömülü olduğunda yeniden dağıtılmasına izin verir. Düzeltmeler - Amazon S3'ten indirilen bir sonuç bloğunun, iptal edilmiş bir denemeden kalan baytları içermesine neden olabilen bir sorun düzeltildi. Sürücü artık her bloğu istenen bayt aralığına karşı denetler ve kısa bir blok alındığında HY000 ve "Result set is incomplete" mesajıyla işlemi başarısız kılar. - SQLColumns işlevinin varbinary sütunu içeren tablolarda başarısız olmasına neden olan bir sorun düzeltildi. Sütun boyutu artık BinaryColumnLength değerinden alınır. - SQLColumns işlevinin interval year to month veya interval day to second sütunu içeren tablo ve görünümlerde başarısız olmasına neden olan bir sorun düzeltildi. - SQL_ATTR_CURRENT_CATALOG, SQL_NTS ile ayarlandığında SQLSetConnectAttrW işlevinin boş bir katalog adı depolamasına neden olan bir sorun düzeltildi. - RowCountPtr null olduğunda SQLRowCount işlevinin çökmesine neden olan bir sorun düzeltildi. - SQL_C_WCHAR çıktısının Basic Multilingual Plane dışındaki karakterleri vekil çiftleri olarak yazması iyileştirildi. SQL_WVARCHAR sütunlarında parçalı SQLGetData artık desteklenir; çağrılar arasında hedef türünün değiştirilmesi de buna dahildir. - SQLBindCol, SQLFetch ve SQLGetData işlevlerinde SQL_C_DEFAULT değerinin çözümlenmeden iletilmesine neden olan bir sorun düzeltildi. - Onaltılık metin olarak okunan ikili bir değerin bir baytın ortasında bitmesine neden olan bir sorun düzeltildi. - Negatif bir interval değerinin işaretinin ilk basamağının üzerine yazılmasına neden olan bir sorun düzeltildi. Interval kesir basamakları artık sütun duyarlılığını izler. - SQLParamData belirtecinin 64 bit platformlarda 32 bit ile sınırlandırılmasına neden olan bir sorun düzeltildi. - SQL_ATTR_METADATA_ID, SQL_TRUE olarak ayarlandığında SQLTables işlevinin null bir TableType bağımsız değişkenini reddetmesine neden olan bir sorun düzeltildi. - UseWCharForStringTypes 0 olduğunda, time with time zone ve timestamp with time zone sonuç sütunlarının oktet uzunluğunun sütun boyutuna eşit olmak yerine VARCHAR sütunlarıymış gibi bildirilmesine neden olan bir sorun düzeltildi. - 30 Şubat gibi olanaksız bir gün içeren tarih ve zaman damgası değerlerinin kabul edilmesine ve 22018 döndürülmemesine neden olan bir sorun düzeltildi. - SQL_DESC_AUTO_UNIQUE_VALUE ve SQL_DESC_CASE_SENSITIVE değerlerinin 4 baytlık tamsayılar yerine 2 baytlık değerler olarak yazılmasına neden olan bir sorun düzeltildi. - Kayan nokta türleri için SQL_COLUMN_PRECISION değerinin ondalık basamaklar yerine bit uzunluğunu döndürmesine neden olan bir sorun düzeltildi. - Hazırlanmış bir REAL sütununun real, yürütülen sonuç kümesinin ise float olarak adlandırılmasına neden olan bir sorun düzeltildi. - VARBINARY sabitlerinin X'...' yerine 0x'...' biçimini kullanmasına neden olan bir sorun düzeltildi. - Bir katalog işlevinden sonra SQLNumParams işlevinin eski bir sayı bildirmesine neden olan bir sorun düzeltildi. - Hatalı biçimlendirilmiş bir varbinary değerinin yalnızca o değer yerine tüm satırın başarısız olmasına neden olan bir sorun düzeltildi. - Bir dize veya ikili değer için çok küçük olan bir SQL_C_BINARY arabelleğinin başarısız olmasına ve verilerin SQLGetData çağrıları arasında döndürülmemesine neden olan bir sorun düzeltildi. - Parçalı SQLGetData işlevinin SQL_NO_TOTAL yerine kalan bayt sayısını bildirmesine neden olan bir sorun düzeltildi. - Sürücünün sağlamadığı eşzamansız yürütme desteğini bildirmesine neden olan bir sorun düzeltildi. Yeni ODBC v2 sürücüsünü indirmek için ODBC 2.x driver download bölümüne bakın. Bağlantı bilgileri için Amazon Athena ODBC 2.x bölümüne bakın.