Zzdats.Lgp.Common.JsonDB.Oracle 10.0.4

Common-JsonDB-Oracle .NET10

Common-JsonDB-Oracle repozitorijs satur kopējo implementācija JSON datu apmaiņai ar Oracle datu bāzes serveri.

Šis repozitorijs ir kā daļa no LGP .Net Core projekta.

Pakas

Pakas nosaukums

Zzdats.Lgp.Common.JsonDB.Oracle

Izmantošana

Izmantošanai nepieciešams Startup klases metodei ConfigureServices pielikt:

            services.AddOracleJsonDB();

Ja nepieciešams visiem novadiem izveidot vienu konekciju, tad nepieciešams pielikt:

            services.AddOracleJsonDB(options =>
            {
                Configuration.GetSection("Lgp:Infrastructure:JsonDB").Bind(options);
                Configuration.GetSection("Lgp:Infrastructure:Service").Bind(options);
            });

Un vides manīgajso iestatīt vērtības:

LGP__INFRASTRUCTURE__JSONDB__USEDISTRICTIDFROMUSERCONTEXT=false
LGP__INFRASTRUCTURE__SERVICE__DISTRICTID=

Tāpat ir nepieciešams, lai projektā būtu implementēta IUserProvider, IModuleSettings un ICssoConnectionProvider no lgpcore/common-core projekta.

Lai pielāgotu Oracle konekcijas parametrus var izmantot appsettings.json. Dokumentācija parametriem šeit: https://docs.oracle.com/en/database/oracle/oracle-database/23/odpnt/ConnectionConnectionString.html

{
    "Oracle": {
        "Pooling": "true",
        "PersistSecurityInfo": "true",
        "MaxPoolSize": "50",
        "MinPoolSize": "0",
        "ConnectionLifeTime": "1800",
        "ValidateConnection": "false",
        "IncrPoolSize": "5",
        "DecrPoolSize": "3",
        "StatementCachePurge": "",
        "StatementCacheSize": ""
    }
}

Šīs vērtības atbilst bibliotēkas noklusējumiem, tāpēc appsettings.json tās jānorāda tikai tad, ja gribat citu vērtību:

ValidateConnection=true liek pūlam pārbaudīt savienojumu pirms izsniegšanas. Tas nav noklusējums apzināti: provaideris atver un aizver savienojumu katram pieprasījumam, tāpēc validācija pievienotu vienu servera apriti katram HTTP pieprasījumam. Ieslēdziet to tikai modulim, kuram savienojuma pārtraukumi atkārtojas, un ar apzinātu latences kompromisu.

Kad šie noklusējumi tiek piemēroti un kad ne

Savienojumu var izveidot divos veidos, un noklusējumus saņem tikai viens:

Otrajā gadījumā bibliotēka gatavajai virknei uzliek tikai tos parametrus, kas ir appsettings.json Oracle: sadaļā. Viss pārējais paliek pie ODP.NET noklusējumiem, tostarp Connection Lifetime=0 — savienojums netiek atjaunots nekad, un pēc datu bāzes pārtraukuma vai failover pūlā paliek bojāti savienojumi.

Kā saprast, kurā gadījumā esat. Ja appsettings.json ir sadaļa ConnectionStrings ar Database (vai citu nosaukumu, kas padots CreateConnection), tad savienojums tiek veidots no virknes un noklusējumi netiek piemēroti. Tādā gadījumā ConnectionLifeTime un MinPoolSize norādiet skaidri — vai nu Oracle: sadaļā, vai pašā savienojuma virknē.