Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Fabric Apps Storage is gebouwd op OneLake en laat je documenten, afbeeldingen en bijlagen aan je app toevoegen. Definieer mappen en toegangsregels met Rayfin, en gebruik vervolgens de client SDK om bestanden te uploaden, te lijsten, downloaden en verwijderen. Houd gestructureerde app-data in je datamodellen.
Bestandsbewerkingen gebruiken Fabric-opslag tijdens de ontwikkeling en na de implementatie; er is geen lokale opslagemulator.
Prerequisites
- Een Fabric Apps-project en Node.js 20 of later.
- De tenantinstelling Gebruikers hebben toegang tot gegevens die in OneLake zijn opgeslagen met apps buiten Fabric is ingeschakeld. Zie OneLake-toegang inschakelen.
- Toegang tot een Fabric-werkruimte met een toegewezen ondersteunde Fabric-capaciteit. Opslag wordt niet ondersteund in Power BI Pro-werkruimtes.
- Toestemming om de app uit te rollen en de opslagconfiguratie toe te passen.
- Een geconfigureerde dataservice, inclusief
services.data.dialect. - Fabric-authenticatie is geconfigureerd voor de app en een inlogflow voor de gebruikers.
Activeer OneLake-toegang
Bestandsuploads en -downloads zijn afhankelijk van OneLake-toegang. Vraag je Fabric-beheerder om de tenantinstelling Users can access data stored in OneLake with apps external to Fabric in te schakelen. Het is standaard ingeschakeld voor de hele organisatie. Fabric Apps Storage vereist dat deze instelling is ingeschakeld. Deze instelling regelt de toegang van applicaties buiten Fabric in het algemeen, niet alleen je app. Je moet ook maprechten definiëren om te bepalen welke bestanden elke app-gebruiker kan benaderen. Voor meer informatie raadpleeg tenantinstellingen van OneLake.
Opslag inschakelen
Gebruik GitHub Copilot of een andere coding agent met toegang tot je project en terminal om opslag te configureren. Gebruik bijvoorbeeld de volgende 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.
Bekijk de gegenereerde configuratie, maprechten en clientwijzigingen. Opslag vereist dat de Dataservice wordt ingeschakeld en geconfigureerd. Elke map vereist een geauthenticeerde machtigingsregel. Maprechten bepalen de toegang tot bestanden; paden organiseren alleen de inhoud. Voor meer informatie over permissies, zie Gegevensmachtigingen definiëren.
De configuratie toepassen
Deploy je app vanaf de projectroot:
npx rayfin up
Een volledige deployment past de geregistreerde mappen toe wanneer Storage is ingeschakeld. Controleer de deploymentuitvoer op opslagwaarschuwingen voordat je de mappen gebruikt. Om een mislukte opslagstap opnieuw te proberen of alleen mapwijzigingen toe te passen op een bestaande deployment, voer je uit:
npx rayfin up storage apply
Je hoeft het opslag-only commando niet meer uit te voeren na een succesvolle volledige deployment.
Ontwikkelen met externe opslag
Begin je ontwikkelsessie:
npx rayfin dev
Door de standaard Fabric-provider te gebruiken, past dit commando ingeschakelde opslagdeclaraties toe op je ontwikkelapp in Fabric. Je frontend draait lokaal, maar bestandsoperaties lezen en schrijven bestanden op afstand. Gebruik een ontwikkelapp en vermijd productiedata tijdens het testen.
Om de opslagconfiguratie voor de actieve ontwikkelingsimplementatie opnieuw uit te voeren, voer je uit:
npx rayfin dev storage apply
Begin een volledige rayfin dev sessie voordat je dit opslag-only commando gebruikt.
Het retry-commando gebruikt de actieve deployment en accepteert geen --workspace of --workspace-id.
Opslag wordt niet ondersteund door de Docker-provider.
De client configureren
Verbind opslag met de bestaande client van je app en behoud de configuratie en aanmeldflow. De setup-prompt kan je helpen de client voor je project te configureren. Aanmeld- en opslagoproepen moeten dezelfde clientsessie gebruiken. Bij het maken van de client wordt een gebruiker niet aangemeld.
Werken met bestanden
De volgende voorbeelden gebruiken je geconfigureerde, ingelogde client instantie en de documents map.
Objectpaden zijn relatief aan die map.
Gebruik / tussen padsegmenten en voeg de bestandsnaam toe voor upload-, download- en verwijderingsoperaties.
Gebruik geen leidende of trailing /, backslashes, lege segmenten, . segmenten of .. segmenten.
Een bestand uploaden
Geef een browser File die door de gebruiker is geselecteerd door:
async function uploadDocument(file: File) {
return client.storage.documents.upload('reports/quarterly-report.pdf', file, {
contentType: 'application/pdf',
contentDisposition: 'attachment; filename="quarterly-report.pdf"',
});
}
Na het uploaden gebruik je hetzelfde pad om het bestand te downloaden of te verwijderen.
Opnieuw uploaden naar hetzelfde pad volgt de onConflict instelling van de map.
De optionele contentDisposition waarde slaat metadata op die beschrijft hoe het bestand gepresenteerd moet worden, zoals een bijlage met een voorgestelde bestandsnaam.
Bestanden in een lijst weergeven
Geef een lijst weer vanaf de mapwortel, of geef een directorypad om de resultaten te versmallen:
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);
}
Roep list() zonder directorypad aan om vanaf de hoofdmap weer te geven.
Gebruik het teruggestuurde voortzettingstoken om extra pagina's op te halen.
De opslag-API kan bestanden in een Deleting staat in lijstresultaten opnemen.
Je kunt een bestand in die staat niet uploaden of downloaden.
Als verwijdering niet wordt voltooid, probeer dan opnieuw het bestand te verwijderen.
Een bestand downloaden
Gebruik hetzelfde relatieve pad dat je tijdens het uploaden hebt opgegeven:
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();
Gebruik de resulterende Blob in de weergave- of downloadflow van je app voor begrensde bestanden.
Deze conversie buffert het hele bestand in het geheugen.
Voor grote bestanden kun je in plaats daarvan result.stream incrementeel verbruiken.
Als je een object-URL aanmaakt met URL.createObjectURL, trek deze dan in wanneer de app hem niet meer nodig heeft.
Een bestand verwijderen
Verwijder het bestand via het relatieve pad:
await client.storage.documents.delete('reports/quarterly-report.pdf');
Als een upload- of verwijderoperatie wordt onderbroken, kan het tijdelijk een andere bewerking op hetzelfde pad blokkeren. Wacht en probeer het opnieuw. In sommige gevallen kan het pad ongeveer 70 minuten geblokkeerd blijven.
Mappen wijzigen of verwijderen
Bewerk mapdeclaraties in je project en pas ze toe met npx rayfin up of npx rayfin up storage apply.
Warning
Het verwijderen van een map uit een toegepaste configuratie maakt deze niet beschikbaar en verwijdert permanent de bestanden. Maak een back-up van alle bestanden die je nodig hebt voordat je de verwijdering uitvoert. Je kunt de map niet herstellen. Je kunt de naam niet hergebruiken totdat het verwijderen is afgerond.
Het verwijderen van een niet-lege map vereist expliciete goedkeuring met --force:
npx rayfin up storage apply --force
Bekijk de verandering voordat je --force gebruikt.
Deze optie maakt dataverlies mogelijk; het is geen routinematige deployment-vlag.
Na verwijdering is de map niet meer beschikbaar terwijl de bestanden op de achtergrond worden verwijderd.
Als de opruiming niet wordt voltooid en je schema nog steeds geregistreerde mappen heeft, voer npx rayfin up storage apply dan opnieuw uit en controleer de output op waarschuwingen.
Als er geen mappen meer geregistreerd zijn, neem dan contact op met de support voor hulp bij het opruimen.
Het verwijderen van alle mapdeclaraties verwijdert niet de gedeployeerde mappen. Gebruik geen lege schemadefinitie als opruimprocedure.
Opslag bewaken
Open in het Fabric-portaal de beheerweergave van je app en selecteer Opslag om de bestanden te inspecteren. Indien beschikbaar, selecteer Metrics en vervolgens Opslag om het aantal opslagverzoeken en het foutpercentage van verzoeken te zien.
Veelgestelde vragen
Heb ik een apart lakehouse- of Azure Storage-account nodig?
No. Fabric Apps gebruikt OneLake-opslag die gekoppeld is aan je app en werkruimte. Je hoeft geen apart Lakehouse- of Azure Storage-account aan te maken.
Leidt het inschakelen van opslag in de app tot het inschakelen van de OneLake-tenantinstelling?
No. Data en Storage inschakelen configureert de diensten van je app; het verandert tenantbeleidsregels niet. Je Fabric-beheerder moet de OneLake-instelling in de vereisten verifiëren.
Hebben app-gebruikers aparte OneLake-inloggegevens nodig?
No. Log gebruikers in bij je app en gebruik de storage SDK met dezelfde geauthenticeerde clientsessie. Beheer de toegang met mapmachtigingen. Anonieme opslagtoegang wordt niet ondersteund.
Wat moet ik controleren als ik geen bestanden kan uploaden of downloaden?
Bevestig dat de OneLake-instelling in de vereisten opslag voor je app toestaat. Zorg ervoor dat de gebruiker is ingelogd en de mapmachtigingen heeft die nodig zijn voor de operatie. Controleer de Rayfin-implementatie-output op opslagwaarschuwingen en pas eventuele mappenwijzigingen toe voordat je het opnieuw probeert.