@@ -3,18 +3,18 @@ title: Azure Storage Files Data Lake client library for .NET
3
3
keywords : Azure, dotnet, SDK, API, Azure.Storage.Files.DataLake, storage
4
4
author : seanmcc-msft
5
5
ms.author : seanmcc
6
- ms.date : 07/11 /2023
6
+ ms.date : 09/12 /2023
7
7
ms.topic : reference
8
8
ms.devlang : dotnet
9
9
ms.service : storage
10
10
---
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
12
12
13
13
14
14
> 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
15
15
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
18
18
across platforms and languages. It removes the complexities of ingesting and storing all of your data
19
19
while making it faster to get up and running with batch, streaming, and interactive analytics.
20
20
@@ -70,7 +70,7 @@ Data Lake Storage Gen2 offers two types of resources:
70
70
71
71
| ADLS Gen2 | Blob |
72
72
| --------------------------| ---------- |
73
- | Filesystem | Container |
73
+ | Filesystem | Container |
74
74
| Path (File or Directory) | Blob |
75
75
76
76
Note: 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
80
80
81
81
### Additional concepts
82
82
<!-- 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 ) |
89
89
[ Client lifetime] ( https://devblogs.microsoft.com/azure-sdk/lifetime-management-and-thread-safety-guarantees-of-azure-sdk-net-clients/ )
90
90
<!-- CLIENT COMMON BAR -->
91
91
@@ -107,7 +107,7 @@ StorageSharedKeyCredential sharedKeyCredential = new StorageSharedKeyCredential(
107
107
DataLakeServiceClient serviceClient = new DataLakeServiceClient (serviceUri , sharedKeyCredential );
108
108
109
109
// Create a DataLake Filesystem
110
- DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (Randomize ( " sample-filesystem" ) );
110
+ DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (" sample-filesystem" );
111
111
filesystem .Create ();
112
112
```
113
113
@@ -119,11 +119,11 @@ StorageSharedKeyCredential sharedKeyCredential = new StorageSharedKeyCredential(
119
119
DataLakeServiceClient serviceClient = new DataLakeServiceClient (serviceUri , sharedKeyCredential );
120
120
121
121
// 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" );
123
123
filesystem .Create ();
124
124
125
125
// Create
126
- DataLakeDirectoryClient directory = filesystem .GetDirectoryClient (Randomize ( " sample-file" ) );
126
+ DataLakeDirectoryClient directory = filesystem .GetDirectoryClient (" sample-file" );
127
127
directory .Create ();
128
128
```
129
129
@@ -132,29 +132,29 @@ directory.Create();
132
132
Create DataLakeFileClient from a DataLakeDirectoryClient
133
133
``` C# Snippet:SampleSnippetDataLakeFileClient_Create_Directory
134
134
// Create a DataLake Directory
135
- DataLakeDirectoryClient directory = filesystem .CreateDirectory (Randomize ( " sample-directory" ) );
135
+ DataLakeDirectoryClient directory = filesystem .CreateDirectory (" sample-directory" );
136
136
directory .Create ();
137
137
138
138
// Create a DataLake File using a DataLake Directory
139
- DataLakeFileClient file = directory .GetFileClient (Randomize ( " sample-file" ) );
139
+ DataLakeFileClient file = directory .GetFileClient (" sample-file" );
140
140
file .Create ();
141
141
```
142
142
143
143
Create DataLakeFileClient from a DataLakeFileSystemClient
144
144
``` C# Snippet:SampleSnippetDataLakeFileClient_Create
145
145
// Create a DataLake Filesystem
146
- DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (Randomize ( " sample-filesystem" ) );
146
+ DataLakeFileSystemClient filesystem = serviceClient .GetFileSystemClient (" sample-filesystem" );
147
147
filesystem .Create ();
148
148
149
149
// Create a DataLake file using a DataLake Filesystem
150
- DataLakeFileClient file = filesystem .GetFileClient (Randomize ( " sample-file" ) );
150
+ DataLakeFileClient file = filesystem .GetFileClient (" sample-file" );
151
151
file .Create ();
152
152
```
153
153
154
154
### Appending Data to a DataLake File
155
155
``` C# Snippet:SampleSnippetDataLakeFileClient_Append
156
156
// Create a file
157
- DataLakeFileClient file = filesystem .GetFileClient (Randomize ( " sample-file" ) );
157
+ DataLakeFileClient file = filesystem .GetFileClient (" sample-file" );
158
158
file .Create ();
159
159
160
160
// Append data to the DataLake File
@@ -178,7 +178,7 @@ foreach (PathItem pathItem in filesystem.GetPaths())
178
178
### Set Permissions on a DataLake File
179
179
``` C# Snippet:SampleSnippetDataLakeFileClient_SetPermissions
180
180
// 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" );
182
182
fileClient .Create ();
183
183
184
184
// Set the Permissions of the file
@@ -189,7 +189,7 @@ fileClient.SetPermissions(permissions: pathPermissions);
189
189
### Set Access Controls (ACLs) on a DataLake File
190
190
``` C# Snippet:SampleSnippetDataLakeFileClient_SetAcls
191
191
// 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" );
193
193
fileClient .Create ();
194
194
195
195
// Set Access Control List
@@ -235,8 +235,8 @@ helpful [`ErrorCode`s][error_codes]. Many of these errors are recoverable.
235
235
236
236
Get started with our [ DataLake samples] [ samples ] :
237
237
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.
240
240
241
241
## Contributing
242
242
@@ -256,8 +256,8 @@ additional questions or comments.
256
256
![ Impressions] ( https://azure-sdk-impressions.azurewebsites.net/api/impressions/azure-sdk-for-net%2Fsdk%2Fstorage%2FAzure.Storage.Files.DataLake%2FREADME.png )
257
257
258
258
<!-- 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
261
261
[ package ] : https://www.nuget.org/packages/Azure.Storage.Files.DataLake/
262
262
[ docs ] : /dotnet/api/azure.storage.files.datalake
263
263
[ rest_docs ] : /rest/api/storageservices/datalakestoragegen2/filesystem
@@ -269,13 +269,13 @@ additional questions or comments.
269
269
[ storage_account_create_portal ] : /azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
270
270
[ azure_cli ] : /cli/azure
271
271
[ 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
274
274
[ 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
276
276
[ cla ] : https://cla.microsoft.com
277
277
[ coc ] : https://opensource.microsoft.com/codeofconduct/
278
278
[ coc_faq ] : https://opensource.microsoft.com/codeofconduct/faq/
279
279
[ coc_contact ] :
mailto:[email protected]
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
281
281
0 commit comments