Skip to content

v1.0.0-preview

Pre-release
Pre-release
Compare
Choose a tag to compare
@AsafMah AsafMah released this 11 Mar 11:36
· 34 commits to master since this release

[1.0.0-preview]

Changed

  • See MIGRATION.md for a migration guide for the changes
  • [BREAKING] The minimal go version is now 1.22
  • [BREAKING] [MAJOR] Split the main module into two packages:
    • azkustodata - contains querying, management APIs.
    • azkustoingest - contains ingestion in all its forms.
  • [BREAKING] [MAJOR] New API for querying, see MIGRATION.md for more details.
  • [BREAKING] [MAJOR] Constructing ingest clients is now done using a KustoConnectionStringBuilder, and not a client struct.
  • [BREAKING] [MAJOR] Changes in the kusto type system:
    • Kusto values will now return a pointer when they are nullable. This applies to all types except for string.
    • Decimal values are now represented as decimal.Decimal instead of string. This is to maintain efficiency and ease of use.
  • In addition, passing a default database and table for ingestion is not necessary anymore, and can be done using Options.
    // before:
     queryClient := kusto.New("https://ingest-somecluster.kusto.windows.net")
     client := ingest.New(quetryClient, "some-db", "some-table")
    
     // after:
     client := azkustoingest.New("https://ingest-somecluster.kusto.windows.net", azkustoingest.WithDefaultDatabase("someDb"), azkustoingest.WithDefaultTable("someTable"))
  • Added autocorrection for endpoints for ingest clients. When creating a client, the "ingest-" will be added or removed as needed. To avoid this behavior, use the azkustoingest.WithoutEndpointCorrection() option.
  • ManagedStreamingClient constructor now only requires the query endpoint, and will infer the ingest endpoint from it. If you want to use a different endpoint, use the azkustoingest.WithCustomIngestConnectionString() option.
  • Removed the old deprecated Stream() method on queued ingest client, instead use azkustoingest.NewStreaming() or azkustoingest.NewManaged() for proper streaming ingest client.
  • Removed QueryIngestion() option for Query client. If you want to perform commands against the dm, create a query client with the "ingest-" endpoint.