Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Fabric Apps Storage är byggt på OneLake och låter dig lägga till dokument, bilder och bilagor till din app. Definiera mappar och åtkomstregler med Rayfin, och använd sedan klientens SDK för att ladda upp, lista, ladda ner och ta bort filer. Behåll strukturerad appdata i dina datamodeller.
Filoperationer använder Fabric-lagring både under utveckling och efter distribution; det finns ingen lokal lagringsemulator.
Prerequisites
- Ett Fabric Apps-projekt och Node.js 20 eller senare.
- Fabric Apps aktiverade för din klientorganisation.
- Klientinställningen Användare kan komma åt data som lagras i OneLake med appar utanför Fabric är aktiverad. Se Aktivera OneLake-åtkomst.
- Tillgång till en Fabric-arbetsyta med en stödd Fabric-kapacitet tilldelad. Lagring stöds inte i Power BI Pro-arbetsytor.
- Behörighet att distribuera appen och tillämpa dess lagringskonfiguration.
- En konfigurerad datatjänst, inklusive
services.data.dialect. - Fabric-autentisering är konfigurerad för appen och ett inloggningsflöde för dess användare.
Aktivera OneLake-åtkomst
Filuppladdningar och nedladdningar beror på OneLake-åtkomst. Be din Fabric-administratör att möjliggöra att användare kan komma åt data lagrad i OneLake med appar utanför Fabric-tenant-inställningen. Det är aktiverat för hela organisationen som standard. Fabric Apps Storage kräver att denna inställning är aktiverad. Denna inställning styr åtkomst från applikationer utanför Fabric generellt, inte bara din app. Du behöver också definiera mappbehörigheter för att styra vilka filer varje appanvändare kan komma åt. För mer information, se OneLake-hyresgästinställningar.
Aktivera lagring
Använd GitHub Copilot eller en annan kodagent med tillgång till ditt projekt och din terminal för att konfigurera lagring. Använd till exempel följande prompt:
Use Rayfin Storage to add a documents folder to my Fabric app.
Allow signed-in users to manage their own PDF files, up to 10 MiB each.
Use the installed Rayfin documentation and project guidance to configure and
register the folder, and connect storage to my existing authenticated client.
Preserve my existing services and folders. Show me the changes before deploying,
and ask before making any potentially destructive changes.
Granska den genererade konfigurationen, mappbehörigheter och klientändringar. Lagring kräver att datatjänsten är aktiverad och konfigurerad. Varje mapp kräver en behörighetsregel för autentiserade användare. Mappbehörigheter styr åtkomsten till filer; sökvägar organiserar endast innehållet. Mer information om behörigheter finns i Definiera behörigheter för data.
Tillämpa inställningarna
Distribuera din app från projektets rot:
npx rayfin up
En fullständig distribution tillämpar de registrerade mapparna när Storage är aktiverat. Kontrollera distributionsutdata för lagringsvarningar innan du använder mapparna. För att försöka igen med ett misslyckat lagringssteg eller endast tillämpa mappändringar på en befintlig distribution, kör:
npx rayfin up storage apply
Du behöver inte köra kommandot för endast lagring efter en lyckad fullständig distribution.
Utveckla mot fjärrlagring
Starta din utvecklingssession:
npx rayfin dev
Genom att använda standardleverantören Fabric applicerar detta kommando aktiverade lagringsdeklarationer på din utvecklingsapp i Fabric. Ditt frontend körs lokalt, men filoperationer läser från och skriver till fjärrfiler. Använd en utvecklingsapp och undvik produktionsdata under testning.
För att köra om lagringskonfigurationen för den aktiva utvecklingsutplaceringen, kör:
npx rayfin dev storage apply
Starta en hel rayfin dev session innan du använder detta lagringskommando.
Kommandot retry använder den aktiva distributionen och godtar varken --workspace eller --workspace-id.
Lagring stöds inte av Docker-leverantören.
Konfigurera klienten
Koppla lagring till din apps befintliga klient och behåll dess konfiguration och inloggningsflöde. Konfigurationsprompten kan hjälpa dig att konfigurera klienten för ditt projekt. Inloggnings- och lagringsanrop måste använda samma klientsession. Att skapa klienten loggar inte in en användare.
Arbeta med filer
Följande exempel använder din konfigurerade, inloggade client instans och mappen documents .
Objektvägar är relativa till mappen.
Använd / mellan vägsegment, och inkludera filnamnet för uppladdnings-, nedladdnings- och borttagningsoperationer.
Använd inte ledande eller släpande /, bakåtslash, tomma segment, . segment eller .. segment.
Ladda upp en fil
Skicka med en webbläsare File som användaren valt:
async function uploadDocument(file: File) {
return client.storage.documents.upload('reports/quarterly-report.pdf', file, {
contentType: 'application/pdf',
contentDisposition: 'attachment; filename="quarterly-report.pdf"',
});
}
När uppladdningen är klar, använd samma sökväg för att ladda ner eller ta bort filen.
Om du laddar upp till samma sökväg igen används mappens onConflict-inställning.
Det valfria contentDisposition värdet lagrar metadata som beskriver hur filen ska presenteras, såsom en bilaga med ett föreslaget filnamn.
Lista filer
Lista från mappens rot, eller ange en katalogväg för att begränsa resultaten:
const firstPage = await client.storage.documents.list('reports', {
limit: 20,
});
for (const item of firstPage.items) {
console.log(item.path, item.size);
}
if (firstPage.continuation) {
const nextPage = await client.storage.documents.list('reports', {
limit: 20,
continuation: firstPage.continuation,
});
console.log(nextPage.items);
}
Anropa list() utan en katalogväg för att lista från mapproten.
Använd den returnerade fortsättningstoken för att hämta ytterligare sidor.
Lagrings-API:t kan inkludera filer i ett Deleting tillstånd i listresultat.
Du kan inte ladda upp eller ladda ner en fil i det tillståndet.
Om raderingen inte slutförs, försök ta bort filen igen.
Ladda ned en fil
Använd samma relativa väg som du angav vid uppladdningen:
const result = await client.storage.documents.download(
'reports/quarterly-report.pdf'
);
const file = await new Response(result.stream, {
headers: result.contentType
? { 'Content-Type': result.contentType }
: undefined,
}).blob();
Använd det resulterande Blob i appens visnings- eller nedladdningsflöde för begränsade filer.
Denna konvertering buffrar hela filen i minnet.
För stora filer, bearbeta result.stream istället stegvis.
Om du skapar en objekt-URL med URL.createObjectURL, återkalla den när appen inte längre behöver den.
Ta bort en fil
Ta bort filen via dess relativa sökväg:
await client.storage.documents.delete('reports/quarterly-report.pdf');
Om en uppladdnings- eller borttagningsoperation avbryts kan den tillfälligt blockera en annan operation på samma sökväg. Vänta och försök igen. I vissa fall kan sökvägen förbli blockerad i cirka 70 minuter.
Ändra eller ta bort mappar
Redigera mappdeklarationer i ditt projekt och applicera dem med npx rayfin up eller npx rayfin up storage apply.
Varning
Att ta bort en mapp från en tillämpad konfiguration gör den otillgänglig och raderar permanent dess filer. Säkerhetskopiera alla filer du behöver innan du genomför borttagningen. Du kan inte återställa mappen. Du kan inte återanvända dess namn förrän raderingen är klar.
Att ta bort en icke-tom mapp kräver uttryckligt godkännande med --force:
npx rayfin up storage apply --force
Gå igenom ändringen innan du använder --force.
Detta alternativ tillåter dataförlust; det är inte en rutinmässig distributionsflagga.
Efter borttagning är mappen otillgänglig medan dess filer raderas i bakgrunden.
Om rensningen inte slutförs och ditt schema fortfarande har registrerade mappar, kör npx rayfin up storage apply om och kontrollera dess utdata för varningar.
Om inga mappar finns kvar registrerade, kontakta supporten för hjälp med sanering.
Att ta bort alla mappdeklarationer raderar inte de distribuerade mapparna. Använd inte en tom schemadefinition som en rensningsprocedur.
Övervaka lagring
I Fabric-portalen, öppna appens hanteringsvy och välj Lagring för att granska dess filer. När det är tillgängligt, välj Mätvärden och välj sedan Lagring för att se antalet lagringsförfrågningar och förfrågningsfelprocenten.
Vanliga frågor och svar
Behöver jag ett separat Lakehouse- eller Azure Storage-konto?
No. Fabric Apps använder OneLake-lagring kopplad till din app och arbetsyta. Du behöver inte skapa ett separat Lakehouse- eller Azure Storage-konto.
Innebär aktivering av lagring i appen att OneLake-klientorganisationsinställningen aktiveras?
No. Att aktivera Data and Storage konfigurerar appens tjänster; det ändrar inte klientorganisationsprinciperna. Din Fabric-administratör måste verifiera OneLake-inställningen i förutsättningarna.
Behöver appanvändare separata OneLake-uppgifter?
No. Logga in användare i din app och använd lagrings-SDK:n med samma autentiserade klientsession. Styr åtkomst med mappbehörigheter. Anonym åtkomst till lagring stöds inte.
Vad ska jag kontrollera om jag inte kan ladda upp eller ladda ner filer?
Bekräfta att OneLake-inställningen i förutsättningarna tillåter lagring för din app. Se till att användaren är inloggad och har de mappbehörigheter som krävs för åtgärden. Kontrollera Rayfin-distributionsutdata för lagringsvarningar och gör mappändringar innan du försöker igen.