ADO.NET Provider for Facebook

Build 26.0.9655

Changelog

General Changes

DateVersionSourceCategoryTypeDescription
2026-05-2726.0.9643GeneralConnectionRemoved
  • Removed the deprecated ReplaceInvalidTypesWithNull connection property. Use the ReplaceInvalidValuesWithNull property instead.
2026-05-0726.0.9623GeneralData ModelAdded
  • Added the ColumnCapabilities column to the sys_tablecolumns system table. This column is a bit mask denoting the column's write capabilities.
2026-04-2826.0.9614ADO.NETConnectionAdded
  • Added the following functions to the driver class. If you pass these functions an exception with no error records, an InvalidArgumentException is thrown.
    • containsErrorSource: Returns true if the exception contains an error record for the provided source name, or false otherwise.
    • getErrorCodeFromSource: Returns the numeric error code from the error record with the given source, or -1 if there is no error record from that source.
    • containsErrorCode: Returns true if the exception contains an error record with the provided error code, or false otherwise.
    • findErrorProperty: Returns the value of the property with the given name, or null if no property with that name is defined.
    • formatErrorRecords: Returns a string containing all the exception's error records, including messages, codes, properties, and error locations.
2026-04-1626.0.9602FacebookData ModelAdded
  • Due to deprecations in the Facebook API, the following metrics have been added to the Insights PageAndPostInsights and CreateInsightSchema:
    • PAGE_TOTAL_MEDIA_VIEW_UNIQUE
    • POST_TOTAL_MEDIA_VIEW_UNIQUE
2026-04-1626.0.9602FacebookData ModelRemoved
  • Due to deprecations in the Facebook API, the following changes have been made to Insights metrics:
    • Removed from PageAndPostInsights and CreateInsightSchema: PAGE_IMPRESSIONS_PAID_UNIQUE, PAGE_IMPRESSIONS_VIRAL_UNIQUE, PAGE_IMPRESSIONS_NONVIRAL_UNIQUE, PAGE_POSTS_IMPRESSIONS, PAGE_POSTS_IMPRESSIONS_UNIQUE, PAGE_POSTS_IMPRESSIONS_PAID, PAGE_POSTS_IMPRESSIONS_PAID_UNIQUE, PAGE_POSTS_IMPRESSIONS_ORGANIC_UNIQUE, PAGE_POSTS_IMPRESSIONS_VIRAL, PAGE_POSTS_IMPRESSIONS_VIRAL_UNIQUE, PAGE_VIDEO_VIEWS_UNIQUE, -POST_IMPRESSIONS_PAID_UNIQUE, POST_IMPRESSIONS_FAN_UNIQUE, POST_IMPRESSIONS_ORGANIC_UNIQUE, POST_IMPRESSIONS_VIRAL_UNIQUE, POST_VIDEO_VIEWS_ORGANIC_UNIQUE, and POST_VIDEO_VIEWS_PAID_UNIQUE.
    • Also removed from PageAndPostInsights and CreateInsightSchema, but substitutes exist: For PAGE_IMPRESSIONS_UNIQUE, substitute the new insight PAGE_TOTAL_MEDIA_VIEW_UNIQUE and existing insight PAGE_MEDIA_VIEW; for POST_IMPRESSIONS_UNIQUE, substitute the new insight POST_TOTAL_MEDIA_VIEW_UNIQUE and existing insight POST_MEDIA_VIEW.
  • Due to deprecations in the Facebook API, the following metrics have been removed from SimpleVideoInsights:
    • TOTAL_VIDEO_IMPRESSIONS
    • TOTAL_VIDEO_IMPRESSIONS_UNIQUE
    • TOTAL_VIDEO_IMPRESSIONS_VIRAL_UNIQUE
    • TOTAL_VIDEO_IMPRESSIONS_VIRAL
    • TOTAL_VIDEO_IMPRESSIONS_FAN_UNIQUE
    • TOTAL_VIDEO_IMPRESSIONS_FAN
    • TOTAL_VIDEO_VIEWS_UNIQUE
2026-04-1526.0.9601GeneralQuery ExecChanged
  • String comparisons using GREATER, LESS, and CONTAINS operators are now case-insensitive by default.
2026-04-0726.0.9593FacebookData ModelChanged
  • Renamed the InsightsByStoryType view to InsightsByActionTypeStory.
2026-04-0726.0.9593FacebookData ModelRemoved
  • In the InsightsByStoryType view, deprecated the following columns: EndTime, UserPost, PagePost, Checkin, Fan, Question, Coupon, Event, Mention, and Other.
2026-04-0126.0.9587ADO.NETAdded
  • Added support for EFCore 10.
2026-03-1625.0.9571FacebookConnectionChanged
  • The GraphAPIVersion and MarketingAPIVersion properties now default to 25.0 in order to utilize the most up-to-date API version.
2026-01-1325.0.9509GeneralAdded
  • Added support for the REGEXP_REPLACE() string function.
2025-12-2925.0.9494FacebookChanged
  • Datetime fields are now reported in the format: yyyy-MM-dd'T'HH:mm:sszzz
2025-12-1225.0.9477FacebookAdded
  • Added INSERT, UPDATE, and DELETE support for the Comments view.
2025-12-0525.0.9470GeneralAdded
  • Added support for the INSERT INTO SELECT statement, with driver-side execution for providers that do not support the operation natively.
2025-10-2325.0.9427FacebookRemoved
  • Removed deprecated insights from the following views due to changes to the Facebook API:
    • InsightsByConsumptionType: PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE, PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE_UNIQUE, POST_CLICKS_BY_TYPE_UNIQUE
    • InsightsByLikeSourceType, InsightsByUnlikeSourceType, and InsightsByFeedbackType: All metrics in these views were deprecated and removed by Facebook, so the views have been removed from the driver.
    • PageAndPostInsights: PAGE_FAN_ADDS, PAGE_FAN_ADDS_UNIQUE, PAGE_FAN_REMOVES, PAGE_FAN_REMOVES_UNIQUE, PAGE_FANS, PAGE_FANS_CITY, PAGE_FANS_COUNTRY, PAGE_FANS_LOCALE, PAGE_IMPRESSIONS, PAGE_IMPRESSIONS_PAID, PAGE_IMPRESSIONS_VIRAL, PAGE_IMPRESSIONS_NONVIRAL, POST_IMPRESSIONS, POST_IMPRESSIONS_PAID, POST_IMPRESSIONS_VIRAL, POST_IMPRESSIONS_FAN.
2025-10-2325.0.9427FacebookAdded
  • Added the following replacement metrics to the PageAndPostInsights view: POST_REACTIONS_LIKE_TOTAL, POST_REACTIONS_LOVE_TOTAL, POST_REACTIONS_WOW_TOTAL, POST_REACTIONS_HAHA_TOTAL, POST_REACTIONS_SORRY_TOTAL, POST_REACTIONS_ANGER_TOTAL, PAGE_FOLLOWS (replaces PAGE_FANS), PAGE_MEDIA_VIEW (replaces PAGE_IMPRESSIONS), POST_MEDIA_VIEW (replaces POST_IMPRESSIONS).
2025-10-0625.0.9410GeneralAdded
  • Support for parsing datetime formats using ".S" and ",S" for milliseconds and nanoseconds.
2025-09-2425.0.9398FacebookChanged
  • Facebook has deprecated the insights in the InsightsByStoryType view and replaced them with POST_ACTIVITY_BY_ACTION_TYPE and POST_ACTIVITY_BY_ACTION_TYPE_UNIQUE. To support this deprecation, we have made the following changes:
    • Columns added: Share, Like, and Comment.
    • Columns deprecated (to be removed in v26): EndTime, UserPost, PagePost, CheckIn, Fan, Question, Coupon, Event, Mention, and Other.
2025-09-1225.0.9386GeneralAdded
  • Added the IsInsertable, IsUpdateable, and IsDeleteable columns to the sys_tables table.
2025-09-1025.0.9384GeneralChanged
  • All columns in statically defined Views are now reported as read-only.
2025-09-0325.0.9377GeneralChanged
  • Corrected the behavior when IN criteria with NULL values are used in the projection part. It now returns NULL instead of 0. For example, "NULL IN (1,2)" returns "NULL".
2025-09-0125.0.9375GeneralAdded
  • Added support for using the CAST function with infinity values. This function can cast "inf" and "-inf" to DOUBLE, FLOAT, or REAL.
2025-08-2125.0.9364GeneralChanged
  • Report behavior change:
    • Fixed inconsistent string value comparisons in non-table queries.
    • For example, "SELECT 'A' = 'a'" previously returned false, but it now returns true.
2025-08-1325.0.9356GeneralChanged
  • Changed the maximum number of pages held in memory from 15 to 5 for the page providers to decrease heap usage.
2025-08-0625.0.9349FacebookChanged
  • Changed the default Graph API and Marketing API versions from 21.0 to 23.0.
2025-06-2525.0.9307GeneralRemoved
  • Removed the "ADLS Gen 1" value from the ConnectionType property.
2025-06-2025.0.9302GeneralAdded
  • Created the following functions:
    • TEXT_ENCODE: encodes a string into a different charset (UTF8 → UTF7 and returns a binary array as the result).
    • TEXT_DECODE: takes a binary array and decodes it back into a string when provided the charset.
    • BASE64_ENCODE: takes a binary array and encodes it as a base64 string (varchar).
    • BASE64_DECODE: takes a base 64-encoded string and decodes it into a binary array.
2025-06-1825.0.9300GeneralChanged
  • The internal code for exception handling has been refactored. Exception messages returned during certain error conditions may now have different wording or formatting.
2025-05-2925.0.9280ADO.NETChanged
  • We have improved our implementation of the ADO.NET DbDataReader.GetDataTypeName so that it now returns database data type names, such as varchar, tinyint, and datetime. Previously we returned the fully-qualified name of the column’s .NET type, in a format like "System.String, System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e".
2025-05-2725.0.9278ADO.NETRemoved
  • Removed support for the C# implementation of SQLite. Features that previously used this implementation by default, such as AutoCache and EF6 schema caching, now require the native SQLite driver.
2025-05-2725.0.9278GeneralRemoved
  • Removed the "Proprietary" enum option from ProxyAuthscheme.
2025-02-1524.0.9177GeneralAdded
  • Added support for converting unsigned integer types to the nearest signed data type that has enough precision to hold the unsigned value.This is done for JDBC only because it does not have support for unsigned data types.
2024-11-2724.0.9097GeneralAdded
  • Added ThreadId to LogModule output. Logfile lines now include the Thread ID associated with the action being performed.
2024-07-1224.0.8959FacebookAdded
  • Added the Thankful, Pride, Care, Fire, and Hundred columns to the InsightsByReactionTotals view.
2024-06-0424.0.8921FacebookAdded
  • Added the PermalinkUrl column to the Posts table.
2024-05-1624.0.8902FacebookRemoved
  • Removed the Groups view due to the deprecation of the view's backing API in all API versions. No replacement functionality has been added.
2024-05-0924.0.8895GeneralChanged
  • The ROUND function previously did not accept negative precision values. That feature has now been restored.
2024-04-2523.0.8881FacebookChanged
  • Changed the default Graph API and Market API versions to 19.0.
2024-03-1523.0.8840GeneralAdded
  • Created a new SQL function called STRING_COMPARE that provides java's String.compare() ability to SQL queries. Returns a number representative of the compared value of two strings
2024-01-1823.0.8783ADO.NETAdded
  • Added support for EFCore 8.
2023-11-2923.0.8733GeneralChanged
  • The ROUND function doesn't accept the negative precision values anymore.
2023-11-2923.0.8733GeneralChanged
  • The returning types of the FDMonth, FDQuarter, FDWeek, LDMonth, LDQuarter, LDWeek functions are changed from Timestamp to Date.
  • The return type of the ABS function will be consistent with the parameter value type.
2023-11-2823.0.8732GeneralAdded
  • Added the HMACSHA256 formatter to allow for secrets to be decoded if it is in base64 format
2023-11-1523.0.8719ADO.NETChanged
  • NuGet license and icon are now embedded within the package itself, in compliance with the package authoring best practices.
2023-07-2623.0.8607FacebookChanged
  • Changed the default Graph API and Market API versions to 17.0.
2023-06-2023.0.8571GeneralAdded
  • Added the new sys_lastresultinfo system table.
2023-06-0723.0.8558FacebookChanged
  • Changed the default Graph API and Market API versions to 16.0.
2023-05-0223.0.8522FacebookChanged
  • Renamed the SimpleInsights table to PageAndPostInsights.
2023-04-2923.0.8519FacebookRemoved
  • Removed the Version connection property. Graph API and Marketing API versions will now be managed internally by the driver, and updated as necessary in new driver releases per API deprecations.
2023-04-2523.0.8515GeneralRemoved
  • Removed support for the SELECT INTO CSV statement. The core code doesn't support it anymore.
2023-04-1923.0.8509ADO.NETRemoved
  • Removed support for EFCore 3.1.
2023-04-1823.0.8508ADO.NETRemoved
  • Removed support for SSRS 2012
2023-04-1823.0.8508ADO.NETAdded
  • Added support for SSRS 2022.
2023-01-1022.0.8410FacebookRemoved
  • Added the Attachments aggregate field for the Posts view, and removed fields from the Posts view that would have previously been associated with only a single attachment for a post. Use the StoryAttachments view to access individual post attachment data from the Attachments aggregate field.
2023-01-1022.0.8410FacebookRemoved
  • Added the Attachments aggregate field for the Comments view, and removed fields from the Comments view that would have previously been associated with only a single attachment for a comment. Use the StoryAttachments view to access individual comment attachment data from the Attachments aggregate field.
2022-12-2822.0.8397FacebookAdded
  • Added the StoryAttachments view, which provides individual rows for each attachment of a set of attachments associated with a post or comment.
2022-12-2822.0.8397FacebookRemoved
  • Added the Attachments aggregate field for the Wall view, and removed fields from the Wall view that would have previously been associated with only a single attachment for a Wall post.
2022-12-1422.0.8383GeneralChanged
  • Added the Default column to the sys_procedureparameters table.
2022-12-0922.0.8378FacebookChanged
  • Changed the API version default of the Version property from 14.0 to 15.0.
2022-10-1222.0.8320FacebookAdded
  • Added FileStream input attribute to add output streams to the CreateInsightSchema stored procedure.
2022-09-3022.0.8308GeneralChanged
  • Added the IsPath column to the sys_procedureparameters table.
2022-06-0822.0.8194ADO.NETRemoved
  • Removed support for VS2010.
2022-05-1922.0.8174ADO.NETRemoved
  • Removed support for .NET 2.0.
2022-04-2722.0.8152ADO.NETRemoved
  • Removed support for EFCore 3.0 and EFCore5.0.
2021-11-0221.0.7976FacebookChanged
  • Updated the maximum pagesize to be unrestricted for most tables. Previously Facebook would throw exceptions if the pagesize was exceeded, but this seems to have been removed.
2021-10-2621.0.7969FacebookChanged
  • The default API version is updated to 12.0.
2021-10-2621.0.7969FacebookRemoved
  • Removed the CreateAppInsights stored procedure. It is now deprecated and scheduled for removal by Facebook.
2021-09-2721.0.7940FacebookAdded
  • Added extra columns for Dimension, Hierarchy and OLAPType to sys_tablecolumns for OLAP properties.
2021-09-0221.0.7915GeneralAdded
  • Added support for the STRING_SPLIT table-valued function in the CROSS APPLY clause.
2021-08-0721.0.7889GeneralChanged
  • Added the KeySeq column to the sys_foreignkeys table.
2021-08-0621.0.7888GeneralChanged
  • Added the new sys_primarykeys system table.
2021-07-2321.0.7874GeneralChanged
  • Updated the Literal Function Names for relative date/datetime functions. Previously, relative date/datetime functions resolved to a different value when used in the projection as opposed to the predicate. For example: SELECT LAST_MONTH() AS lm, Col FROM Table WHERE Col > LAST_MONTH(). Formerly, the two LAST_MONTH() methods would resolve to different datetimes. Now, they will match.
  • As a replacement for the previous behavior, the relative date/datetime functions in the criteria may have an 'L' appended to them. For example: WHERE col > L_LAST_MONTH(). This will continue to resolve to the same values that were previously calculated in the criteria. Note that the "L_" prefix will only work in the predicate - it not available for the projection.
2021-06-1421.0.7835FacebookChanged
  • The default API version is updated to 11.0.
  • Facebook has removed access from apps to return comment ids when the user does not also have permissions to moderate the comments. This may mean in some cases comments will stop returning with our driver when they were working previously.
  • The user_likes and user_posts permissions (no longer used by default with the embedded driver) now have much more difficult requirements to access them from Facebook.
  • Nearly all unique page type columns for the Pages table were deprecated by Facebook. For example, Parking columns, GeneralInfo, Attire, Restaurant Services columns, Awards, etc. These will all start returning null as Facebook transitions to the New Page Experience. These columns will be removed in the 2022 release of the driver.
2021-06-0721.0.7828ADO.NETAdded
  • Added support for the DbCommand.CommandTimeout property.
2021-05-2921.0.7819ADO.NETRemoved
  • Removed support for SSRS 2008.
2021-04-2521.0.7785GeneralAdded
  • Added support for handling client side formulas during insert / update. For example: UPDATE Table SET Col1 = CONCAT(Col1, " - ", Col2) WHERE Col2 LIKE 'A%'
2021-04-2321.0.7783GeneralChanged
  • Updated how display sizes are determined for varchar primary key and foreign key columns so they will match the reported length of the column.
2021-04-1621.0.7776ADO.NETChanged
  • Separated the ADO.NET Provider assembly and Entity Framework Core 5 Nuget packages.
  • Single precision floating point numbers are now reported as with the Data Type Name as "real". Double precision floating point numbers now have their Data Type Name reported as "float". This change does not impact the actual data types of these columns - only the reported data type name.
  • Separate EFCore 3.0, 3.1 and EFCore 5 dlls are now shipped with the driver. The 2.0 and 2.1 EFCore dlls are removed.
2021-04-1621.0.7776GeneralAdded
  • Non-conditional updates between two columns is now available to all drivers. For example: UPDATE Table SET Col1=Col2
2021-04-1621.0.7776GeneralChanged
  • Reduced the length to 255 for varchar primary key and foreign key columns.
2021-04-1621.0.7776GeneralChanged
  • Updated implicit and metadata caching to improve performance and support for multiple connections. Old metadata caches are not compatible - you need to generate new metadata caches if you are currently using CacheMetadata.
2021-04-1621.0.7776GeneralChanged
  • Updated index naming convention to avoid duplicates.
2021-04-1321.0.7773FacebookChanged
  • Updated the default Version to 10.0.
2021-03-1921.0.7748FacebookDeprecated
  • The Permissions connection property is deprecated and replaced with Scope to match other drivers.

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 26.0.9655