Del via

Dataflow Gen2 datadestinationsvalideringsregler

Dataflow Gen2 i Fabric Data Factory understøtter forskellige datadestinationer til lagring af transformerede data. Ligesom med datakilder har datadestinationer specifikke valideringsregler for at sikre dataintegritet, og at data under opdateringsoperationer skrives korrekt. Denne artikel skitserer valideringsreglerne for datadestinationer, der understøttes af Dataflow Gen2.

Hvordan validering fungerer

Når du konfigurerer en datadestination for en forespørgsel i Dataflow Gen2, udfører systemet valideringskontroller for at sikre, at:

  • Destinationsforespørgslen er korrekt konfigureret og kan findes
  • Destinationsscriptet returnerer en gyldig type
  • Datakildereferencer i destinationsforespørgslen løses korrekt
  • Der findes kun én destinationsforespørgsel pr. output

Disse valideringskontroller kører under publiceringsprocessen og ved starten af hver opdateringsoperation. Hvis valideringen fejler, fejler dataflowet enten i at publicere, eller opdateringsoperationen blokeres, indtil problemet er løst.

Når validering sker

Validering af datadestinationer sker på flere tidspunkter i dataflowets livscyklus:

Fase Beskrivelse
Forfatterskab Grundlæggende validering sker, når du konfigurerer datadestinationen i Power Query-editoren.
Udgivelse Fuld validering kører, når du offentliggør din dataflow. Eventuelle valideringsfejl forhindrer publiceringen i at blive færdig.
Opdatere Validering kører i starten af hver opdatering for at sikre, at destinationen stadig er gyldig og tilgængelig.

Udarbejdelse af valideringsregler for datadestinationer

Følgende tabel viser de valideringsregler for forfattere, der gælder for datadestinationer i Dataflow Gen2. Disse regler hjælper med at sikre, at datadestinationer konfigureres korrekt.

Valideringsregel Beskrivelse
DestinationQueryNotFound Destinationsforespørgslen kunne ikke findes. Denne fejl opstår, når den interne forespørgsel, der indeholder navigationstrinene til din destination, mangler eller er blevet fjernet.
DestinationTransformQueryNotFound Forespørgslen om destinationstransformen kunne ikke findes. Denne fejl opstår, når en forespørgsel om destinationstransform forventes (som defineret i destinationsindstillingerne), men ikke kan findes. Bemærk, at tabeldestinationer ikke har en transformationsforespørgsel.
DestinationQueryChallenge Destinationsforespørgslen stødte på en udfordring under valideringen. Dette indikerer typisk et autentificerings- eller autorisationsproblem, når der forbindes til destinationen.
DestinationQueryException Destinationsforespørgslen stødte på en undtagelse under valideringen. Denne fejl indikerer, at der opstod en uventet fejl under valideringen af destinationsforespørgslen.
DestinationQueryHasUnsupportedScript Destinationsforespørgslen indeholder et ikke-understøttet script. Denne fejl kan opstå, når destinationsscriptet returnerer en ugyldig type (ikke tabel, binær eller null), eller når datakildens opløsning fejler på grund af flere eller nul datakilder, der refereres i destinationsforespørgslen, eller en ugyldig ressourcetype. En kendt begrænsning er at bruge flere ressourcetyper i en enkelt destinationsforespørgsel, såsom en Warehouse-destinationsforespørgsel, der inkluderer en trinfiltrering med en parameter, hvis værdier kommer fra en Lakehouse.
MultipleDestinationQueries Flere destinationsforespørgsler blev fundet, selvom kun én forventes. Denne validering eksisterer, fordi den interne kontrakt understøtter et array af destinationer, men standardforfatteroplevelsen tillader kun at konfigurere én destination pr. forespørgsel. Denne fejl kan opstå, når dataflow-definitioner redigeres direkte gennem CI/CD.
UkendtFejl En ukendt fejl opstod under valideringen, typisk forårsaget af netværksproblemer eller servicefejl. Denne fejl vises ikke i brugerfladen og resulterer i en stille fejl.

Fejlfinding af valideringsfejl

Når du støder på en valideringsfejl, brug følgende vejledning til at løse problemet.

DestinationQueryNotFound og DestinationTransformQueryNotFound

Disse fejl indikerer, at de interne destinationsforespørgsler mangler. Sådan løser du:

  1. Åbn dit dataflow i Power Query-editoren.
  2. Fjern den eksisterende datadestination fra den berørte forespørgsel.
  3. Rekonfigurer datadestinationen ved at vælge Add data destination fra bånd- eller forespørgselsindstillingerne.
  4. Publicér dataflowet igen.

DestinationQueryChallenge

Denne fejl indikerer typisk et autentificeringsproblem. Sådan løser du:

  1. Bekræfte, at dine forbindelsesoplysninger stadig er gyldige.
  2. Tjek at du har de rette tilladelser på destinationen.
  3. Prøv at redigere forbindelsen og genautentificere.
  4. Hvis du bruger en service principal, skal du sikre dig, at legitimationerne ikke er udløbet.

DestinationQueryException

Denne fejl indikerer, at der opstod en uventet undtagelse. Sådan løser du:

  1. Tjek status på destinationstjenesten for at sikre, at den er tilgængelig.
  2. Verificér, at destinationstabellen eller filstien stadig eksisterer.
  3. Gennemgå eventuelle nylige ændringer i destinationsskemaet eller tilladelserne.
  4. Prøv at fjerne og omkonfigurere datadestinationen.

DestinationQueryHasUnsupportedScript

Denne fejl kan opstå af flere årsager. Sådan løser du:

  1. Ugyldig returtype: Sørg for, at din destinationsforespørgsel returnerer en tabel-, binær eller nullværdi. Funktioner, lister og andre typer understøttes ikke som destinationer.
  2. Ingen datakilder: Sørg for, at din destinationsforespørgsel har en gyldig datakildereference.
  3. Flere ressourcetyper: Undgå at blande forskellige ressourcetyper i en enkelt destinationsforespørgsel. For eksempel skal du ikke bruge en Warehouse-destinationsforespørgsel, der filtrerer med en parameter, hvis værdier kommer fra et Lakehouse. Brug i stedet ressourcer af samme slags eller omstrukturer dit dataflow.

MultipleDestinationQueries

Denne fejl opstår, når en forespørgsel har flere destinationskonfigurationer, hvilket kan ske, når dataflow-definitioner redigeres direkte gennem CI/CD. Den standard forfatteroplevelse tillader kun én destination pr. forespørgsel. Sådan løser du:

  1. Gennemgå dataflow-definitionen for at identificere forespørgsler med flere destinationer konfigureret.
  2. Fjern duplikerede destinationskonfigurationer fra definitionen.
  3. Hvis du skal indlæse data til flere destinationer, skal du oprette separate forespørgsler for hver destination.

UkendtFejl

Da denne fejl ikke vises i brugerfladen, kan du måske opleve det som en lydløs opdateringsfejl. Sådan foretager du fejlfinding:

  1. Tjek opdateringshistorikken for yderligere fejloplysninger.
  2. Prøv at fjerne og omkonfigurere datadestinationen.
  3. Hvis problemet fortsætter, kan du overveje at genskabe dataflowet.

Bedste praksis for datadestinationer

For at undgå valideringsfejl og sikre pålidelig dataindlæsning:

  • Test forbindelser regelmæssigt: Kontroller jævnligt, at dine destinationsforbindelser virker, og at dine legitimationsoplysninger er gyldige.
  • Brug administrerede indstillinger: Brug når muligt, automatiske indstillinger for nye tabeller, så Dataflow Gen2 kan styre kortlægningen for dig.
  • Overvåg opdateringshistorik: Tjek regelmæssigt din dataflow-opdateringshistorik for at opdage eventuelle problemer tidligt.
  • Dokumentér dine dataflows: Hold styr på, hvilke forespørgsler der indlæses til hvilke destinationer for at gøre fejlfinding lettere.

Relateret indhold

  • Last updated on