Update Core to 2.24.

.github/workflows/nightly.yml

@@ -27,7 +27,7 @@ jobs:
           - os: windows-latest
             platform: windows-x86_64
           - tag: dev
-        tag: [release-2.23, dev]
+        tag: [release-2.24, dev]
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout TileDB
@@ -72,7 +72,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        tag: [release-2.23, dev]
+        tag: [release-2.24, dev]
     runs-on: ubuntu-latest
     steps:
       - name: Checkout TileDB-CSharp
@@ -113,7 +113,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        tag: [release-2.23, dev]
+        tag: [release-2.24, dev]
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout TileDB-CSharp

Directory.Packages.props

@@ -3,7 +3,7 @@
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
     <TileDBNativePackageName>TileDB.Native</TileDBNativePackageName>
     <TileDBNativeVersionMajor>2</TileDBNativeVersionMajor>
-    <TileDBNativeVersionMinor>23</TileDBNativeVersionMinor>
+    <TileDBNativeVersionMinor>24</TileDBNativeVersionMinor>
     <TileDBNativePackageVersion>[$(TileDBNativeVersionMajor).$(TileDBNativeVersionMinor).0,$(TileDBNativeVersionMajor).$([MSBuild]::Add($(TileDBNativeVersionMinor), 1)).0)</TileDBNativePackageVersion>
 
     <!-- The DevelopmentBuild property switches to the locally built native packages.

sources/TileDB.CSharp/Array.cs

@@ -329,6 +329,18 @@ public void Create(ArraySchema schema)
         Create(_ctx, _uri, schema);
     }
 
+    /// <summary>
+    /// Deletes an array from storage.
+    /// </summary>
+    /// <param name="ctx">The <see cref="CSharp.Context"/> to use.</param>
+    /// <param name="uri">The array's URI.</param>
+    public static void Delete(Context ctx, string uri)
+    {
+        using var msUri = new MarshaledString(uri);
+        using var ctxHandle = ctx.Handle.Acquire();
+        ctx.handle_error(Methods.tiledb_array_delete(ctxHandle, msUri));
+    }
+
     /// <summary>
     /// Applies an <see cref="ArraySchemaEvolution"/> to the schema of an array.
     /// </summary>
@@ -367,6 +379,20 @@ public void Evolve(ArraySchemaEvolution schemaEvolution)
         Evolve(_ctx, _uri, schemaEvolution);
     }
 
+    /// <summary>
+    /// Upgrades the storage format version of an array.
+    /// </summary>
+    /// <param name="ctx">The <see cref="CSharp.Context"/> to use.</param>
+    /// <param name="uri">The array's URI.</param>
+    /// <param name="config">Optional <see cref="CSharp.Config"/> to customize the process.</param>
+    public static void UpgradeVersion(Context ctx, string uri, Config? config = null)
+    {
+        using var msUri = new MarshaledString(uri);
+        using var ctxHandle = ctx.Handle.Acquire();
+        using var configHandle = config?.Handle.Acquire() ?? default;
+        ctx.handle_error(Methods.tiledb_array_upgrade_version(ctxHandle, msUri, configHandle));
+    }
+
     /// <summary>
     /// Consolidates an array.
     /// </summary>

sources/TileDB.CSharp/TileDB.CSharp.csproj

@@ -6,12 +6,12 @@
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <Nullable>enable</Nullable>
     <RootNamespace>TileDB.CSharp</RootNamespace>
-    <Version>5.13.0</Version>
+    <Version>5.14.0</Version>
     <Description>C# wrapper of the TileDB Embedded universal data engine.</Description>
     <PackageReadmeFile>README.md</PackageReadmeFile>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <EnablePackageValidation>true</EnablePackageValidation>
-    <PackageValidationBaselineVersion>5.12.0</PackageValidationBaselineVersion>
+    <PackageValidationBaselineVersion>5.13.0</PackageValidationBaselineVersion>
     <NoWarn>$(NoWarn);TILEDB0012;TILEDB0013;TILEDB0014</NoWarn>
   </PropertyGroup>
 

sources/TileDB.CSharp/VFS.cs

@@ -381,7 +381,7 @@ public List<string> GetChildren(string uri)
     /// <returns>A <see cref="List{T}"/> containing the files of the directory in <paramref name="uri"/>
     /// and their sizes.</returns>
     /// <remarks>
-    /// This operation is supported only on URIs to AWS S3.
+    /// This operation is supported only on URIs to local file system, S3, Azure and GCS.
     /// </remarks>
     public List<(string Uri, ulong Size)> GetChildrenRecursive(string uri)
     {
@@ -439,7 +439,7 @@ public void VisitChildren<T>(string uri, Func<string, T, bool> callback, T callb
     /// <param name="callbackArg">An argument that will be passed to <paramref name="callback"/>.</param>
     /// <typeparam name="T">The type of <paramref name="callbackArg"/>.</typeparam>
     /// <remarks>
-    /// This operation is supported only on local filesystem and AWS S3 URIs.
+    /// This operation is supported only on URIs to local file system, S3, Azure and GCS.
     /// </remarks>
     public void VisitChildrenRecursive<T>(string uri, Func<string, ulong, T, bool> callback, T callbackArg)
     {

tests/TileDB.CSharp.Test/ArrayTest.cs

@@ -23,7 +23,7 @@ public void TestDenseArray()
         var array = new Array(context, tmpArrayPath);
         Assert.IsNotNull(array);
 
-        var array_schema = BuildDenseArraySchema(context);
+        var array_schema = ArrayTest.BuildDenseArraySchema(context);
         Assert.IsNotNull(array_schema);
 
         array.Create(array_schema);
@@ -75,7 +75,7 @@ public void TestSparseArray()
         var array = new Array(context, tmpArrayPath);
         Assert.IsNotNull(array);
 
-        var array_schema = BuildSparseArraySchema(context);
+        var array_schema = ArrayTest.BuildSparseArraySchema(context);
         Assert.IsNotNull(array_schema);
 
         array.Create(array_schema);
@@ -133,7 +133,7 @@ public void TestConsolidateFragments()
 
         using var uri = new TemporaryDirectory("array_consolidate_fragments");
 
-        using (var schema = BuildDenseArraySchema(context))
+        using (var schema = ArrayTest.BuildDenseArraySchema(context))
         using (var array = new Array(context, uri))
         {
             array.Create(schema);
@@ -170,7 +170,43 @@ public void TestConsolidateFragments()
         Assert.AreEqual(FragmentCount, fragmentInfo.FragmentToVacuumCount);
     }
 
-    private ArraySchema BuildDenseArraySchema(Context context)
+    [TestMethod]
+    public void TestDelete()
+    {
+        var context = Context.GetDefault();
+
+        using var uri = new TemporaryDirectory("array_delete");
+
+        using (var schema = BuildDenseArraySchema(context))
+        {
+            Array.Create(context, uri, schema);
+        }
+
+        Assert.AreEqual(ObjectType.Array, context.GetObjectType(uri));
+
+        Array.Delete(context, uri);
+
+        Assert.AreEqual(ObjectType.Invalid, context.GetObjectType(uri));
+    }
+
+    [TestMethod]
+    public void TestUpgradeVersion()
+    {
+        var context = Context.GetDefault();
+
+        using var uri = new TemporaryDirectory("array_upgrade_version");
+
+        using (var schema = BuildDenseArraySchema(context))
+        {
+            Array.Create(context, uri, schema);
+        }
+
+        Assert.AreEqual(ObjectType.Array, context.GetObjectType(uri));
+
+        Array.UpgradeVersion(context, uri);
+    }
+
+    private static ArraySchema BuildDenseArraySchema(Context context)
     {
         var dimension = Dimension.Create<short>(context, "dim1", 1, 10, 5);
         Assert.IsNotNull(dimension);
@@ -199,7 +235,7 @@ private ArraySchema BuildDenseArraySchema(Context context)
         return array_schema;
     }
 
-    private ArraySchema BuildSparseArraySchema(Context context)
+    private static ArraySchema BuildSparseArraySchema(Context context)
     {
         var dim1 = Dimension.Create<short>(context, "dim1", 1, 10, 5);
         Assert.IsNotNull(dim1);