Zen ADO.NET Entity Framework Core データプロバイダー

Zen ADO.NET Entity Framework (EF) Core は、クロスプラットフォーム開発をサポートする .NET 用の軽量で拡張可能なオブジェクトリレーショナルマッパー（O/RM）です。これにより、開発者は .NET オブジェクトを使用してデータベースを操作できるようになり、データ中心のアプリケーションで記述および保守する必要のあるコードの量を減らすことができます。

Zen ADO.NET Entity Framework Core データプロバイダーは、ADO.NET Entity Framework Core を使用するアプリケーションで使用できます。以下をサポートしています。

•

Microsoft ADO.NET Entity Framework Core 8.0

•

.NET Standard 8.0 でサポートされるすべてのプラットフォーム。詳細については、https://docs.microsoft.com/ja-jp/dotnet/standard/net-standard を参照してください。

•

Microsoft Entity Framework Core および Actian Zen データベースの両方でサポートされるすべての機能。詳細については、https://docs.microsoft.com/ja-jp/ef/core/what-is-new/ を参照してください。

Zen ADO.NET Entity Framework Core データプロバイダーは、ADO.NET データプロバイダーを使用して ADO.NET データベースサーバーと通信します。つまり、Zen ADO.NET データプロバイダーによって定義された機能は、ここで特に断りがない限り、Zen ADO.NET Entity Framework Core データプロバイダーに適用されるということです。同様に、Zen ADO.NET データプロバイダーに合わせて作られたすべてのパフォーマンス構成が、Zen ADO.NET Entity Framework Core データプロバイダーで実現されます。

メモ：Zen ADO.NET Entity Framework Core のアプリケーションを開発する場合は、Visual Studio 2022 以降が必要です。

Zen ADO.NET Entity Framework Core データプロバイダーについて

Zen ADO.NET Entity Framework Core データプロバイダーはマネージコードのみで構築されています。つまり、完全に共通言語ランタイム（CLR）の内部で、実行およびデータベースへの接続が行えます。

クライアントライブラリや COM コンポーネントなどネイティブオペレーティングシステムで実行するコードはアンマネージコードと言います。マネージコードとアンマネージコードは 1 つのアプリケーション内に混在させることができます。ただし、アンマネージコードは共通言語ランタイムの外部にまで影響が及ぶため、現実的には複雑になり、パフォーマンスも低下します。また、セキュリティの危険にさらすことにもなりかねません。

名前空間

Zen ADO.NET Entity Framework Core データプロバイダーの名前空間は、Actian.EntityFrameworkCore.Zen です。

アセンブリ名

Zen ADO.NET Entity Framework Core データプロバイダーは、Actian.EntityFrameworkCore.Zen.dll という名前のアセンブリを使用します。

これを使用するには、SDK ダウンロードで入手できる Zen ADO.NET データプロバイダーに示されているお使いのバージョンの最新 SDK の .zip アーカイブをダウンロードして、NuGet パッケージ Actian.EntityFrameworkCore.Zen を展開します。その後、プロジェクトにパッケージを追加します。

Zen ADO.NET Entity Framework Core データプロバイダーの構成

ADO.NET Entity Framework Core データプロバイダーを構成するには

.NET Standard 8.0 を対象とするアプリケーションを作成します。詳細については、https://learn.microsoft.com/ja-jp/dotnet/core/tutorials/with-visual-studio?pivots=dotnet-8-0 を参照してください

NuGet パッケージ Actian.EntityFrameworkCore.Zen をインストールします。

新しいコンテキストクラスをアプリケーションに追加し、次のコードを使用して OnConfiguring メソッドをオーバーライドします。

public class MyContext : DbContext

{

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)

=> optionsBuilder.UseZen(connection string);

}

Zen ADO.NET Entity Framework Core データプロバイダーでの接続文字列の使用

Zen ADO.NET Entity Framework Core データプロバイダーは接続文字列に含まれている情報を使用して、Entity Framework Core をサポートする基となる Zen ADO.NET データプロバイダーに接続します。

接続文字列オプションのデフォルト値の変更

Zen ADO.NET Entity Framework Core データプロバイダーで使用される接続文字列オプションのデフォルト値の多くは、Zen ADO.NET データプロバイダーで使用されるデフォルト値と同じです。詳細については、接続文字列プロパティを参照してください。次の接続文字列オプションの一覧は、ADO.NET Entity Framework Core アプリケーションで使用される場合には異なるデフォルト値になるオプションを示しています。

接続文字列オプション	ADO.NET Entity Framework Core アプリケーションでのデフォルト値
Parameter Mode	サポートされません。
Statement Cache Mode	ExplicitOnly 値のみサポートされます。
DB File Directory Path	Environment.SpecialFolder.CommonApplicationData。Environment.SpecialFolder 列挙型およびサポートされるフィールドの詳細については、https://docs.microsoft.com/ja-jp/dotnet/api/system.environment.specialfolder?view=net-8.0 を参照してください。

Code First のサポート

Entity Framework Core は Code First の機能をサポートしています。これらの機能のサポートを実装すると、長い識別子名の処理に必要な変更など、データプロバイダーへの変更が必要になります。ただし、アプリケーションの変更は必要ありません。

Code First の実装は型マッピングの変更を必要とします。詳細については、Code First の型マッピングを参照してください。

長い識別子名の処理

ほとんどの Zen 識別子の最大長は 20 バイトです。サーバー上で作成するオブジェクトの名前はクラス名とプロパティ名から取られるため、識別子名がこのサイズを超える場合があります。また、制約名は多くの場合、いくつかのオブジェクト名を連結して作成されます。このような場合には、識別子の最大長を超える可能性がさらに大きくなります。

列の場合、データプロバイダーは識別子の末尾をチルダ文字 ~ に置き換えることにより、識別子をデータベースで許容される識別子の最大長に短縮します。たとえば、文字列 ColumnMoreThanTwentyCharacters は ColumnMoreThanTwent~ に短縮されます。

テーブルの場合、データプロバイダーは識別子の末尾を整数のハッシュコードに置き換えることにより、識別子をデータベースで許容される識別子の最大長に短縮します。たとえば、文字列 ATableWithAVeryLongTableName は ATableWit_1738385675 に短縮されます。

DB ツールを使用して DB オブジェクトのアクセスや表示を行った場合、作成されたテーブルの名前が、モデルクラス名とプロパティ名から予想される名前とは異なる場合があります。

ADO.NET Entity Framework Core での Code First Migrations の使用

Entity Framework Core では Code First Migrations をサポートしています。これにより、データベースを削除して再作成しなくても、データベーススキーマを更新することでモデルクラスを反映できるようになります。

移行は、モデルの変更に従って、データベーススキーマを増分で更新できるようにします。データベースに対する各変更セットは、移行として知られるコードファイルで表されます。移行は、通常、タイムスタンプを使用して管理され、データベース内のテーブルは、どの移行がデータベースに適用されたかを追跡します。

Code First Migrations は型マッピングの変更を必要とします。詳細については、Code First の型マッピングを参照してください。

Code First Migrations を実装するには、Zen ADO.NET Entity Framework Core データプロバイダーを構成した時点で、NuGet パッケージ Microsoft.EntityFrameworkCore.Tools（バージョン 3.1）をインストールします。

リバースエンジニアリングの使用（スキャフォールディング）

データベーススキーマに基づいてエンティティ型クラスおよび DbContext クラスをスキャフォールディングする処理は、リバースエンジニアリングと呼ばれます。これは、EF Core パッケージマネージャーコンソール（PMC）ツールの Scaffold-DbContext コマンド、または .NET コマンドラインインターフェイス（CLI）ツールの dotnet ef dbcontext scaffold コマンドを使用して実行できます。

ADO.NET Actian Zen Entity Framework Core データプロバイダーでリバースエンジニアリングを使用するには、データプロバイダーを構成した後、次の手順を実行します。

NuGet パッケージ Microsoft.EntityFrameworkCore.Tools（バージョン 8.0.0）をインストールします。

次の Scaffold-DbContext PowerShell コマンドを実行します。

Scaffold-DbContext 'connection string' Actian.EntityFrameworkCore.Zen

必要に応じて、Scaffold-DbContext PowerShell コマンドにパラメーターを追加することができます。詳細については、https://docs.microsoft.com/ja-jp/ef/core/managing-schemas/scaffolding?tabs=vs を参照してください。

.NET Core CLI 環境でリバースエンジニアリングを使用する場合は、https://docs.microsoft.com/ja-jp/ef/core/managing-schemas/scaffolding?tabs=dotnet-core-cli を参照してください。

Code First の型マッピング

次の表はモデル中心の型マッピングを示しています。このマッピングでは、CLR 型は、データベースの作成時に使用される Zen（ストア）型に影響を与えます。一部の CLR 型はいくつかの異なる Zen 型にマップすることができます。

列は次のように定義されています。

•

［CLR 型］列は、共通言語ランタイムの型名を示しています。

•

［型マッピングに影響を与えるプロパティ値］列は、型マッピングに影響を及ぼす可能性のある、あらゆるプロパティ値を示しています。

•

［Zen 型］列は、ネイティブな型名を示しています。

CLR 型	型マッピングに影響を与えるプロパティ値	Actian Zen データ型
Boolean		BIT
Byte		UTINYINT
Byte[ ]		BINARY LONGVARBINARY1
DateTime		AUTOTIMESTAMP DATE TIMESTAMP TIMESTAMP22
DateTimeOffset		DATETIME
Decimal		CURRENCY DECIMAL2 NUMERIC NUMERICSA NUMERICSTS UBIGINT
Double		BFLOAT8 DOUBLE2
Float		FLOAT2 REAL BFLOAT4
Guid		UNIQUEIDENTIFIER
Integer		INTEGER2 IDENTITY USMALLINT
Long		BIGINT2 BIGIDENTITY UINTEGER
SByte		TINYINT
Short		SMALLINT2 SMALLIDENTITY
String		NLONGVARCHAR2
	Unicode=False	LONGVARCHAR
	MaxLength= (1<=n<=8000) Fixed Length=False Unicode=True	NVARCHAR
	MaxLength= (1<=n<=8000) Fixed Length=False Unicode=False	VARCHAR
	MaxLength= (1<=n<=8000) Fixed Length=True Unicode=True	NCHAR
	MaxLength= (1<=n<=8000) Fixed Length=True Unicode=False	CHAR
TimeSpan		TIME
1. MaxLength に値が指定されていない場合は、この型にマップされます。 2. デフォルトでは、この型にマップされます。

EDM 正規関数から Zen 関数へのマッピング

ADO.NET Entity Framework Core は、エンティティデータモデル（EDM）正規関数を Zen ADO.NET Entity Framework Core データプロバイダーの対応するデータソース機能に変換します。これによって、全データソースに共通する形式で表現される関数を呼び出すことができます。

これらの正規関数はデータソースから独立しているため、正規関数の引数の型と戻り値の型は、EDM の型の語句で定義されます。Entity SQL クエリで正規関数を使用すると、データソースで適切な関数が呼び出されます。

すべての正規関数には、ヌルが入力された場合の動作とエラー状況が明示的に指定されています。ただし、ADO.NET Entity Framework Core はこの動作を実行しません。

集計正規関数

次の表は、EDM 集計正規関数から Zen 関数へのマッピング、およびこれらの関数が適用される CLR 型を示します。

集計正規関数	Actian Zen 関数	CLR 型
BigCount(expression)	COUNT_BIG(expression)	Long
Count(expression)	COUNT(expression)	Integer

数学正規関数

次の表は、EDM 数学正規関数から Zen 関数へのマッピング、およびこれらの関数が適用される CLR 型を示します。

数学正規関数	Actian Zen 関数	CLR 型
Abs(expression)	ABS(expression)	Decimal、Double、Float、Int、Long、SByte、Short
Ceiling(expression)	CEILING(expression)	Decimal、Double
Floor(expression)	FLOOR(expression)	Decimal、Double
Pow(base, power)	POWER(base, power)	Double
Exp(expression)	EXP(expression)	Double
Log10(expression)	LOG10(expression)	Double
Log(expression)	LOG(expression)	Double
Sqrt(expression)	SQRT(expression)	Double
Acos(expression)	ACOS(expression)	Double
Asin(expression)	ASIN(expression)	Double
Atan(expression)	ATAN(expression)	Double
Atan2(expression1, expression2)	ATAN2(expression1, expression2)	Double
Cos(expression)	COS(expression)	Double
Sin(expression)	SIN(expression)	Double
Tan(expression)	TAN(expression)	Double
Sign(expression)	SIGN(expression)	Decimal、Double、Float、Int、Long、SByte、Short

日付と時刻の正規関数

次の表は、EDM の日付と時刻の正規関数から Zen 関数へのマッピングを示します。これらの関数は、日付時刻データを使用する型の生成、処理、および操作を行います。また、この表はこれらの関数が適用される CLR 型も示しています。

日付と時刻の正規関数	Actian Zen 関数	CLR 型
DateTime.Now	SYSDATETIME()	DateTime
DateTime.Now	SYSDATETIMEOFFSET()	DateTimeOffset
DateTime.UtcNow	SYSUTCDATETIME()	DateTime DateTimeOffset
DateTime.Today	CURDATE()	DateTime DateTimeOffset
AddYears(expression)	DATEADD(year, expression, column)	DateTime DateTimeOffset
AddMonths(expression)	DATEADD(month, expression, column)	DateTime DateTimeOffset
AddDays(expression)	DATEADD(day, expression, column)	DateTime DateTimeOffset
AddHours(expression)	DATEADD(hour, expression, column)	DateTime DateTimeOffset
AddMinutes(expression)	DATEADD(minute, expression, column)	DateTime DateTimeOffset
AddSeconds(expression)	DATEADD(second, expression, column)	DateTime DateTimeOffset
AddMilliSeconds(expression)	DATEADD(millisecond, expression, column)	DateTime DateTimeOffset
EF.Functions.DateDiffYear(column, expression)	DATEDIFF(year, column, expression)	DateTime DateTimeOffset
EF.Functions.DateDiffMonth(column, expression)	DATEDIFF(month, column, expression)	DateTime DateTimeOffset
EF.Functions.DateDiffDay(column, expression)	DATEDIFF(day, column, expression)	DateTime DateTimeOffset
EF.Functions.DateDiffHour(column, expression)	DATEDIFF(hour, column, expression)	DateTime DateTimeOffset TimeSpan
EF.Functions.DateDiffMinute(column, expression)	DATEDIFF(minute, column, expression)	DateTime DateTimeOffset TimeSpan
EF.Functions.DateDiffSecond(column, expression)	DATEDIFF(second, column, expression)	DateTime DateTimeOffset TimeSpan
EF.Functions.DateDiffMilliSecond(column, expression)	DATEDIFF(millisecond, column, expression)	DateTime DateTimeOffset TimeSpan

文字列正規関数

次の表は、EDM 文字列正規関数から Zen 関数へのマッピング、およびこれらの関数が適用される CLR 型を示します。

文字列正規関数	Actian Zen 関数	CLR 型
IndexOf(expression)	POSITION(expression, column)	String
Replace(toReplace, replaceWith)	REPLACE(toReplace, column, replaceWith)	String
ToLower()	LOWER(column)	String
ToUpper()	UPPER(column)	String
SubString(start, length)	SUBSTRING(column, start, length)	String
IsNullOrWhiteSpace()	列の LTRIM および RTRIM と、ヌルチェックの組み合わせ	String
TrimStart()	LTRIM(column)	String
TrimEnd()	RTRIM(column)	String
TRIM()	列の LTRIM と RTRIM の組み合わせ	String
Contains(expression)	POSITION(expression, column)	String
StartsWith(expression)	列の LEFT と LENGTH の組み合わせ	String
EndsWith(expression)	列の RIGHT と LENGTH の組み合わせ	String
Length()	LENGTH(column)	String
EF.Functions.Position(column, expression)	POSITION(expression, column)	String