@@ -3,18 +3,18 @@ title: Azure Storage Files Data Lake client library for .NET
33keywords : Azure, dotnet, SDK, API, Azure.Storage.Files.DataLake, storage
44author : seanmcc-msft
55ms.author : seanmcc
6- ms.date : 07/11 /2023
6+ ms.date : 09/12 /2023
77ms.topic : reference
88ms.devlang : dotnet
99ms.service : storage
1010---
11- # Azure Storage Files Data Lake client library for .NET - version 12.15 .0
11+ # Azure Storage Files Data Lake client library for .NET - version 12.16 .0
1212
1313
1414> Server Version: 2021-02-12, 2020-12-06, 2020-10-02, 2020-08-04, 2020-06-12, 2020-04-08, 2020-02-10, 2019-12-12, 2019-07-07, and 2019-02-02
1515
16- Azure Data Lake includes all the capabilities required to make it easy for developers, data scientists,
17- and analysts to store data of any size, shape, and speed, and do all types of processing and analytics
16+ Azure Data Lake includes all the capabilities required to make it easy for developers, data scientists,
17+ and analysts to store data of any size, shape, and speed, and do all types of processing and analytics
1818across platforms and languages. It removes the complexities of ingesting and storing all of your data
1919while making it faster to get up and running with batch, streaming, and interactive analytics.
2020
@@ -70,7 +70,7 @@ Data Lake Storage Gen2 offers two types of resources:
7070
7171| ADLS Gen2 | Blob |
7272| --------------------------| ---------- |
73- | Filesystem | Container |
73+ | Filesystem | Container |
7474| Path (File or Directory) | Blob |
7575
7676Note: This client library does not support hierarchical namespace (HNS) disabled storage accounts.
@@ -80,12 +80,12 @@ We guarantee that all client instance methods are thread-safe and independent of
8080
8181### Additional concepts
8282<!-- CLIENT COMMON BAR -->
83- [ Client options] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/core/Azure.Core/README.md#configuring-service-clients-using-clientoptions ) |
84- [ Accessing the response] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/core/Azure.Core/README.md#accessing-http-response-details-using-responset ) |
85- [ Long-running operations] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/core/Azure.Core/README.md#consuming-long-running-operations-using-operationt ) |
86- [ Handling failures] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/core/Azure.Core/README.md#reporting-errors-requestfailedexception ) |
87- [ Diagnostics] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/core/Azure.Core/samples/Diagnostics.md ) |
88- [ Mocking] ( https://github. com/Azure /azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15.0/ sdk/core/Azure.Core/README.md# mocking ) |
83+ [ Client options] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/core/Azure.Core/README.md#configuring-service-clients-using-clientoptions ) |
84+ [ Accessing the response] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/core/Azure.Core/README.md#accessing-http-response-details-using-responset ) |
85+ [ Long-running operations] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/core/Azure.Core/README.md#consuming-long-running-operations-using-operationt ) |
86+ [ Handling failures] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/core/Azure.Core/README.md#reporting-errors-requestfailedexception ) |
87+ [ Diagnostics] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/core/Azure.Core/samples/Diagnostics.md ) |
88+ [ Mocking] ( https://learn.microsoft. com/dotnet /azure/ sdk/unit-testing- mocking ) |
8989[ Client lifetime] ( https://devblogs.microsoft.com/azure-sdk/lifetime-management-and-thread-safety-guarantees-of-azure-sdk-net-clients/ )
9090<!-- CLIENT COMMON BAR -->
9191
@@ -107,7 +107,7 @@ StorageSharedKeyCredential sharedKeyCredential = new StorageSharedKeyCredential(
107107DataLakeServiceClient serviceClient = new DataLakeServiceClient (serviceUri , sharedKeyCredential );
108108
109109// Create a DataLake Filesystem
110- DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (Randomize ( " sample-filesystem" ) );
110+ DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (" sample-filesystem" );
111111filesystem .Create ();
112112```
113113
@@ -119,11 +119,11 @@ StorageSharedKeyCredential sharedKeyCredential = new StorageSharedKeyCredential(
119119DataLakeServiceClient serviceClient = new DataLakeServiceClient (serviceUri , sharedKeyCredential );
120120
121121// Get a reference to a filesystem named "sample-filesystem-append" and then create it
122- DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (Randomize ( " sample-filesystem-append" ) );
122+ DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (" sample-filesystem-append" );
123123filesystem .Create ();
124124
125125// Create
126- DataLakeDirectoryClient directory = filesystem .GetDirectoryClient (Randomize ( " sample-file" ) );
126+ DataLakeDirectoryClient directory = filesystem .GetDirectoryClient (" sample-file" );
127127directory .Create ();
128128```
129129
@@ -132,29 +132,29 @@ directory.Create();
132132Create DataLakeFileClient from a DataLakeDirectoryClient
133133``` C# Snippet:SampleSnippetDataLakeFileClient_Create_Directory
134134// Create a DataLake Directory
135- DataLakeDirectoryClient directory = filesystem .CreateDirectory (Randomize ( " sample-directory" ) );
135+ DataLakeDirectoryClient directory = filesystem .CreateDirectory (" sample-directory" );
136136directory .Create ();
137137
138138// Create a DataLake File using a DataLake Directory
139- DataLakeFileClient file = directory .GetFileClient (Randomize ( " sample-file" ) );
139+ DataLakeFileClient file = directory .GetFileClient (" sample-file" );
140140file .Create ();
141141```
142142
143143Create DataLakeFileClient from a DataLakeFileSystemClient
144144``` C# Snippet:SampleSnippetDataLakeFileClient_Create
145145// Create a DataLake Filesystem
146- DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (Randomize ( " sample-filesystem" ) );
146+ DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (" sample-filesystem" );
147147filesystem .Create ();
148148
149149// Create a DataLake file using a DataLake Filesystem
150- DataLakeFileClient file = filesystem .GetFileClient (Randomize ( " sample-file" ) );
150+ DataLakeFileClient file = filesystem .GetFileClient (" sample-file" );
151151file .Create ();
152152```
153153
154154### Appending Data to a DataLake File
155155``` C# Snippet:SampleSnippetDataLakeFileClient_Append
156156// Create a file
157- DataLakeFileClient file = filesystem .GetFileClient (Randomize ( " sample-file" ) );
157+ DataLakeFileClient file = filesystem .GetFileClient (" sample-file" );
158158file .Create ();
159159
160160// Append data to the DataLake File
@@ -178,7 +178,7 @@ foreach (PathItem pathItem in filesystem.GetPaths())
178178### Set Permissions on a DataLake File
179179``` C# Snippet:SampleSnippetDataLakeFileClient_SetPermissions
180180// Create a DataLake file so we can set the Access Controls on the files
181- DataLakeFileClient fileClient = filesystem .GetFileClient (Randomize ( " sample-file" ) );
181+ DataLakeFileClient fileClient = filesystem .GetFileClient (" sample-file" );
182182fileClient .Create ();
183183
184184// Set the Permissions of the file
@@ -189,7 +189,7 @@ fileClient.SetPermissions(permissions: pathPermissions);
189189### Set Access Controls (ACLs) on a DataLake File
190190``` C# Snippet:SampleSnippetDataLakeFileClient_SetAcls
191191// Create a DataLake file so we can set the Access Controls on the files
192- DataLakeFileClient fileClient = filesystem .GetFileClient (Randomize ( " sample-file" ) );
192+ DataLakeFileClient fileClient = filesystem .GetFileClient (" sample-file" );
193193fileClient .Create ();
194194
195195// Set Access Control List
@@ -235,8 +235,8 @@ helpful [`ErrorCode`s][error_codes]. Many of these errors are recoverable.
235235
236236Get started with our [ DataLake samples] [ samples ] :
237237
238- 1 . [ Hello World] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/Azure.Storage.Files.DataLake/samples/Sample01a_HelloWorld.cs ) : Append, Read, and List DataLake Files (or [ asynchronously] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/Azure.Storage.Files.DataLake/samples/Sample01b_HelloWorldAsync.cs ) )
239- 2 . [ Auth] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/Azure.Storage.Files.DataLake/samples/Sample02_Auth.cs ) : Authenticate with public access, shared keys, shared access signatures, and Azure Active Directory.
238+ 1 . [ Hello World] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/Azure.Storage.Files.DataLake/samples/Sample01a_HelloWorld.cs ) : Append, Read, and List DataLake Files (or [ asynchronously] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/Azure.Storage.Files.DataLake/samples/Sample01b_HelloWorldAsync.cs ) )
239+ 2 . [ Auth] ( https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/Azure.Storage.Files.DataLake/samples/Sample02_Auth.cs ) : Authenticate with public access, shared keys, shared access signatures, and Azure Active Directory.
240240
241241## Contributing
242242
@@ -256,8 +256,8 @@ additional questions or comments.
256256![ Impressions] ( https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-net%2Fsdk%2Fstorage%2FAzure.Storage.Files.DataLake%2FREADME.png )
257257
258258<!-- LINKS -->
259- [ samples ] : https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/Azure.Storage.Files.DataLake/samples
260- [ source ] : https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/Azure.Storage.Files.DataLake/src
259+ [ samples ] : https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/Azure.Storage.Files.DataLake/samples
260+ [ source ] : https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/Azure.Storage.Files.DataLake/src
261261[ package ] : https://www.nuget.org/packages/Azure.Storage.Files.DataLake/
262262[ docs ] : /dotnet/api/azure.storage.files.datalake
263263[ rest_docs ] : /rest/api/storageservices/datalakestoragegen2/filesystem
@@ -269,13 +269,13 @@ additional questions or comments.
269269[ storage_account_create_portal ] : /azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
270270[ azure_cli ] : /cli/azure
271271[ azure_sub ] : https://azure.microsoft.com/free/dotnet/
272- [ identity ] : https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.15 .0/sdk/identity/Azure.Identity/README.md
273- [ RequestFailedException ] : https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.15 .0/sdk/core/Azure.Core/src/RequestFailedException.cs
272+ [ identity ] : https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.16 .0/sdk/identity/Azure.Identity/README.md
273+ [ RequestFailedException ] : https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Files.DataLake_12.16 .0/sdk/core/Azure.Core/src/RequestFailedException.cs
274274[ error_codes ] : /rest/api/storageservices/blob-service-error-codes
275- [ storage_contrib ] : https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/CONTRIBUTING.md
275+ [ storage_contrib ] : https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/CONTRIBUTING.md
276276[ cla ] : https://cla.microsoft.com
277277[ coc ] : https://opensource.microsoft.com/codeofconduct/
278278[ coc_faq ] : https://opensource.microsoft.com/codeofconduct/faq/
279279[ coc_contact ] : mailto:opencode@microsoft.com
280- [ https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/Azure.Storage.Files.DataLake/samples ] : https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.15 .0/sdk/storage/Azure.Storage.Files.DataLake/samples
280+ [ https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/Azure.Storage.Files.DataLake/samples ] : https://github.com/Azure/azure-sdk-for-net/blob/Azure.Storage.Files.DataLake_12.16 .0/sdk/storage/Azure.Storage.Files.DataLake/samples
281281
0 commit comments