Amazon Athena ODBC Driver2.5.0.0

Этот выпуск драйвера Amazon Athena ODBC 2.x включает изменения, внесённые после версии 2.4.0.0. Перед обновлением ознакомьтесь с критическими изменениями. Значения параметров подключения, которые более ранние версии игнорировали, теперь приводят к сбою подключения. Критические изменения - Проверка AuthenticationType – Теперь драйвер отклоняет любое значение AuthenticationType, не входящее в число документированных значений, и завершает подключение с кодом HY000 вместо возврата к учётным данным IAM. Теперь значение Default принимается как сокращённая форма Default Credentials. Дополнительные сведения см. в разделе Параметры аутентификации. - Проверка UseSingleCatalogAndSchema – Теперь драйвер принимает для UseSingleCatalogAndSchema только значения 0 или 1. Любое другое значение приводит к сбою подключения с кодом HY000. Дополнительные сведения см. в разделе Использование одного каталога и схемы. - Проверка LogLevel – Теперь драйвер завершает подключение с кодом HY000, если значение LogLevel ему неизвестно, а значение LogLevel, применяемое ко всему драйверу, отличное от OFF, теперь требует указания LogPath. Дополнительные сведения см. в разделе Параметры ведения журнала. - Сообщение об ошибках перечисления каталогов AWS Glue – Если при просмотре нескольких каталогов не удаётся перечислить каталоги AWS Glue по причине, отличной от отказа в доступе или отсутствия сущности, например из-за ограничения частоты запросов, функция работы с каталогами теперь завершается с кодом HY000 и сообщением, начинающимся с [AmazonAthena][GlueClientError], вместо возврата сокращённого списка. Дополнительные сведения см. в разделе Переопределение конечной точки AWS Glue. - Принудительное использование режима одного каталога и схемы – При значении UseSingleCatalogAndSchema=1 функции работы с каталогами теперь возвращают только настроенные Catalog и Schema, не вызывая Athena или AWS Glue. Это также предотвращает ошибку Power BI "cannot convert the value null to type Record". Чтобы перечислить все каталоги и схемы, задайте UseSingleCatalogAndSchema=0. Дополнительные сведения см. в разделе Использование одного каталога и схемы. - Отключение шаблонов поиска каталогов при SQL_ATTR_METADATA_ID – Если для подключения задано значение SQL_TRUE атрибута SQL_ATTR_METADATA_ID, аргументы функций работы с каталогами в его инструкциях теперь обрабатываются как идентификаторы, а не как шаблоны поиска, поэтому аргументы с подстановочными знаками больше не дают совпадений. Улучшения - Переопределение конечной точки AWS Glue – Добавлен параметр GlueEndpointOverride для задания конечной точки для вызовов AWS Glue, используемых при просмотре нескольких каталогов. Дополнительные сведения см. в разделе Переопределение конечной точки AWS Glue. - Длина двоичного столбца – Добавлен параметр BinaryColumnLength для задания размера столбца, сообщаемого драйвером для столбцов varbinary. Дополнительные сведения см. в разделе Длина двоичного столбца. - Кэширование подключений – Добавлен параметр EnableConnectionCaching. Если задано значение 1, драйвер кэширует результат вызова GetWorkGroup, выполняемого при подключении, на пять минут для каждого процесса драйвера. Дополнительные сведения см. в разделе Включение кэширования подключений. - Учётные данные профиля IAM – Подключения, использующие подключаемый модуль аутентификации IAM Profile, теперь перезагружают учётные данные при изменении файла учётных данных или файла конфигурации AWS для выбранного профиля. Дополнительные сведения см. в разделе Профиль IAM. - Дополнения SQLGetInfo – Добавлены SQL_ODBC_VER, SQL_XOPEN_CLI_YEAR, SQL_ODBC_SAG_CLI_CONFORMANCE, а также маски преобразования SQL_CONVERT_WCHAR, SQL_CONVERT_WVARCHAR и SQL_CONVERT_WLONGVARCHAR. - Сообщения об ошибках запроса – Если запрос Athena завершается с пустым сообщением об ошибке, драйвер теперь сообщает причину изменения состояния, которую Athena возвращает для запроса. - Ключевые слова SQLBrowseConnect – SQLBrowseConnect теперь перечисляет AuthenticationType, AwsProfile, Catalog, Schema, SessionToken и Workgroup как необязательные ключевые слова. - Специфические SQLSTATE – Неподдерживаемые или неизвестные атрибуты и типы SQLGetInfo, SQLDescribeParam и ошибки преобразования теперь возвращают определённые SQLSTATE вместо простого SQL_ERROR или общего кода. - SQLSTATE при сбое подключения – Сбой подключения из-за вызова GetWorkGroup, выполняемого при подключении, теперь возвращает 28000 для ошибок учётных данных, 08004 для ошибок запроса, таких как отсутствие рабочей группы, 08S01 для сетевых ошибок и ошибок тайм-аута запроса, а в остальных случаях — 08001. - Метаданные каталогов для широких символов – При значении UseWCharForStringTypes=1 SQLColumns и результирующие наборы каталогов теперь сообщают типы широких символов и длины в байтах. Дополнительные сведения см. в разделе Использование WCHAR для строковых типов. - Обновление лицензии – Теперь лицензия драйвера разрешает распространение скомпилированного драйвера, если он встроен в ваш продукт. Исправления - Исправлена проблема, из-за которой блок результата, загруженный из Amazon S3, мог содержать устаревшие байты из прерванной попытки. Теперь драйвер проверяет каждый блок по отношению к запрошенному диапазону байтов и завершает обработку короткого блока с кодом HY000 и сообщением "Result set is incomplete". - Исправлена проблема, из-за которой SQLColumns завершалась сбоем для таблиц со столбцом varbinary. Размер столбца теперь берётся из BinaryColumnLength. - Исправлена проблема, из-за которой SQLColumns завершалась сбоем для таблиц и представлений со столбцом типа interval year to month или interval day to second. - Исправлена проблема, из-за которой SQLSetConnectAttrW сохраняла пустое имя каталога, когда SQL_ATTR_CURRENT_CATALOG задавался со значением SQL_NTS. - Исправлена проблема, из-за которой SQLRowCount аварийно завершала работу, если RowCountPtr имел значение null. - Улучшена запись вывода SQL_C_WCHAR: символы за пределами базовой многоязычной плоскости теперь записываются как суррогатные пары. Теперь поддерживается фрагментированная SQLGetData для столбцов SQL_WVARCHAR, включая изменение целевого типа между вызовами. - Исправлена проблема, из-за которой SQL_C_DEFAULT в SQLBindCol, SQLFetch и SQLGetData передавался без разрешения. - Исправлена проблема, из-за которой двоичное значение, прочитанное как шестнадцатеричный текст, завершалось в середине байта. - Исправлена проблема, из-за которой знак отрицательного интервала перезаписывал его первую цифру. Теперь цифры дробной части интервала соответствуют точности столбца. - Исправлена проблема, из-за которой токен SQLParamData на 64-разрядных платформах усекался до 32 бит. - Исправлена проблема, из-за которой SQLTables при установленном значении SQL_TRUE атрибута SQL_ATTR_METADATA_ID отклоняла аргумент TableType со значением null. - Исправлена проблема, из-за которой длина октетов столбцов результатов типа time with time zone и timestamp with time zone сообщалась так, как если бы эти столбцы имели тип VARCHAR, вместо значения, равного размеру столбца, когда UseWCharForStringTypes имеет значение 0. - Исправлена проблема, из-за которой значения даты и временной метки с невозможным днём, например 30 февраля, принимались вместо возврата 22018. - Исправлена проблема, из-за которой SQL_DESC_AUTO_UNIQUE_VALUE и SQL_DESC_CASE_SENSITIVE записывались как 2-байтовые значения вместо 4-байтовых целых чисел. - Исправлена проблема, из-за которой SQL_COLUMN_PRECISION для типов с плавающей точкой возвращал длину в битах вместо числа десятичных цифр. - Исправлена проблема, из-за которой подготовленный столбец REAL имел имя real, тогда как выполненный результирующий набор называл его float. - Исправлена проблема, из-за которой литералы VARBINARY использовали форму 0x'...' вместо X'...'. - Исправлена проблема, из-за которой SQLNumParams сообщал устаревшее количество после функции работы с каталогом. - Исправлена проблема, из-за которой некорректное значение varbinary приводило к сбою всей строки, а не только этого значения. - Исправлена проблема, из-за которой буфер SQL_C_BINARY, слишком малый для строкового или двоичного значения, приводил к сбою вместо возврата данных через вызовы SQLGetData. - Исправлена проблема, из-за которой фрагментированная SQLGetData сообщала SQL_NO_TOTAL вместо количества оставшихся байтов. - Исправлена проблема, из-за которой драйвер сообщал о поддержке асинхронного выполнения, которой он не предоставляет. Чтобы скачать новый драйвер ODBC v2, см. раздел Загрузка драйвера ODBC 2.x. Сведения о подключении см. в разделе Amazon Athena ODBC 2.x.