[matias-mcl]

Summary

Updates all SQL Race examples for the new CompositeSession API.

Changes

New examples demonstrating CompositeSession API:

• LoadSSNWtihAssociates() — Load file session with associates via FileSessionManager.LoadCompositeSession
• LoadSqlRaceDatabaseSessionWithAssociates() — Load from SQL database via SessionManager.LoadCompositeSession
• LoadSessionViaQueryManagerWithAssociate() — Discover sessions via QueryManager, then load as composite
• CreateFunctionAcrossMultipleSessionsWithCompositeSession() — Create FDL functions that span primary + associate sessions
• AppendSessions() — Append multiple sessions into a composite session

New file:

• FunctionHelper.cs — Utility for creating FDL function definitions (single and multi-parameter)

API migration:

• SetSQLRaceConnection — last param changed from int (0/1/2) to bool for delete-on-close
• RecordersConfiguration.AddConfiguration — same int → bool change
• Removed LoadSSNWithAssociatedMerge() (old merging flow)
• Removed CreateSessionWithTimeZoneValue() (moved to separate PR TimeZone Property SQL Race Example #57)
• Renamed LoadAssociated() → GetAssociatedSessionSummaries()

Supersedes

• Load With Associates Examples #55 (Load With Associates Examples)
• Mdr/matias/composite session changes #58 (Mdr/matias/composite session changes)

[ma-bristow]

Should bin off LoadSSNWtihAssociates to be LoadAndAppendSSNSessions as it isn't limited to an Associate session.

Similarly

        /// <summary>
        ///     This example loads a Primary session and appends another session (but multiple can base passed in) in order to
        ///     create a Composite Session (a session made up of one or more sessions).
        ///     It then retrieves and prints a small number of sample values for a
        ///     specified parameter from both the Primary and the Appended session(s).
        /// </summary>

And then all variables referring to an associate do not make sense.

[ma-bristow]

Similar to the above, this is not locked down to an Associate so should refer to the action of Appending.

Rather than LoadSqlRaceDatabaseSessionWithAssociates something like LoadAndAppendSqlRaceDatabaseSessions

        /// <summary>
        ///     This example demonstrates how to load a Primary session and Append a session
        ///     from a SQL backed session database in order to create a Composite Session
        ///     (a session made up of one or more sessions). It then retrieves and prints
        ///     a small number of sample values for a specified parameter from both the
        ///     Primary session and its Appended session.
        /// </summary>

And then all variables referring to an associate do not make sense.

[ma-bristow]

Not sure this statement is correct?

[ma-bristow]

Summary mentions Associate sessions but it is Appending any session.

Need to update variables with and comments to be Appended related rather than associates.

[ma-bristow]

My original PR had a comment for me to

               var samples = pda.GetNextSamples(10);
               if (samples == null)
               {
                   Console.WriteLine($"Failed to get samples for {primaryParameterIdentifier}");
                   return;
               }

Forgot to add a check to make sure we have samples.

[ma-bristow]

Original PR has a comment to

               var samples = pda.GetNextSamples(10);
               if (samples == null)
               {
                   Console.WriteLine($"Failed to get samples for {associateParameterIdentifier}");
                   return;
               }

Forgot to add a check to make sure we have samples.

[ma-bristow]

From Previous PR.

// ===================== REMINDER =====================
// To use Functions, LicenceProgramName must be "ATLAS Data Platform"
// =====================================================

Might be worth adding a reminder above the editable section.

[ma-bristow]

From Previous PR.

      var buildResults = functionManager.Build(functionDefinition);
      if (buildResults .Errors.Any())
      {
          Console.WriteLine("Function build failed.");
          foreach (var error in buildResults .Errors)
          {
              Console.WriteLine($"{error}");
          }
          return;
      }

Forgot to actually build the function. Needs to happen before we build the PDA.

[ma-bristow]

The return session summaries...

[ma-bristow]

The name of the composite should probably be "AppendSessions", or something other than CompositeSessionWithvTagSessionsTest.