API FileSystem WebHDFS

Azure Data Lake Store è un file system su scala cloud compatibile con Hadoop Distributed File System (HDFS) e funziona con l'ecosistema Hadoop. Le applicazioni o i servizi esistenti che usano l'API WebHDFS possono essere facilmente integrati con ADLS.

URL per le chiamate REST

Un URL REST WebHDFS tipico è simile al seguente:

http://<HOST>:<PORT>/webhdfs/v1/<PATH>?op=<OP>...

Per eseguire il mapping di questo URL per una chiamata REST a Data Lake Store, apportare le modifiche seguenti:

• Usare https anziché http

• Per <HOST>, usare il nome dell'account completo, ad esempio <data_lake_store_name>.azuredatalakestore.net

• è :<PORT> facoltativo

Di conseguenza, un URL dell'endpoint REST per Data Lake Store usando le API WebHDFS dovrebbe essere simile al seguente:

https://<data_lake_store_name>.azuredatalakestore.net/webhdfs/v1/<PATH>?op=<OP>... 

Passaggio del token di autorizzazione nell'intestazione del messaggio

Data Lake Store usa Azure Active Directory per autorizzare le chiamate REST. Tutte le chiamate REST a Data Lake Store devono includere un token di autorizzazione come parte dell'intestazione del messaggio. Per una discussione dettagliata su come Azure Active Directory usa OAuth, vedere OAuth2.0 in Azure Active Directory. Per istruzioni su come richiedere un token di autorizzazione, vedere Ricerca per categorie eseguire l'autenticazione con Azure Active Directory.

Nota

Per un elenco di intestazioni e parametri comuni necessari per le chiamate a Data Lake Store, vedere Parametri e intestazioni comuni.

API conformi a WebHDFS per Data Lake Store

La tabella seguente elenca le API WebHDFS che possono essere usate con Data Lake Store. Se applicabile, la tabella elenca anche la deviazione dalle API WebHDFS standard, ad esempio se alcuni parametri non sono supportati o quando alcuni parametri sono supportati in modo diverso.

Nota

Data Lake Store supporta attualmente WebHDFS versione 2.7.2.

API WebHDFS con Data Lake Store	Richiesta-risposta	Considerazioni importanti
CREATE	Vedere qui	I parametri di richiesta seguenti non sono supportati. - blocksize : è fisso a 256 MB e non può essere modificato. - replication : viene gestito internamente da Data Lake Store. Anche se si specifica questo parametro, verrà ignorato e non verrà restituito alcun errore. - buffersize : è fisso a 4 MB e non può essere modificato.
APPEND	Vedere qui	I parametri di richiesta seguenti non sono supportati: - buffersize : è fisso a 4 MB e non può essere modificato
CONCAT	Vedere qui	-
OPEN	Vedere qui	I parametri di richiesta seguenti non sono supportati: - buffersize : è fisso a 4 MB e non può essere modificato
MKDIRS	Vedere qui	-
RENAME	Vedere qui	-
DELETE	Vedere qui	-
GETFILESTATUS	Vedere qui	I parametri di risposta seguenti sono supportati in modo diverso: - type : SYMLINK non è supportato in modo che non venga restituito; FILE e DIRECTORY saranno.
LISTSTATUS	Vedere qui	-
GETCONTENTSUMMARY	Vedere qui	I parametri di risposta seguenti non sono supportati: - quota : Data Lake Store non restituisce la quota. - spaceQuota - Data Lake Store non restituisce spaceQuota.
SETPERMISSION	Vedere qui	-
SETOWNER	Vedere qui	-
MODIFYACLENTRIES	Vedere qui	-
REMOVEACLENTRIES	Vedere qui	-
SETACL	Vedere qui	-
GETACLSTATUS	Vedere qui	-
CHECKACCESS	Vedere qui	-