Merge pull request #253213 from jonburchel/patch-36

Update connector-troubleshoot-guide.md

Author: prmerger-automator[bot]

articles/data-factory/connector-troubleshoot-guide.md

@@ -43,7 +43,7 @@ You can refer to the troubleshooting pages for each connector to see problems sp
 
 The errors below are general to the copy activity and could occur with any connector.
 
-### Error code: JreNotFound
+#### Error code: JreNotFound
 
 - **Message**: `Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.`
 
@@ -52,7 +52,7 @@ The errors below are general to the copy activity and could occur with any conne
 - **Recommendation**:  Check your integration runtime environment, see [Use Self-hosted Integration Runtime](./format-parquet.md#using-self-hosted-integration-runtime).
 
 
-### Error code: WildcardPathSinkNotSupported
+#### Error code: WildcardPathSinkNotSupported
 
 - **Message**: `Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.`
 
@@ -79,53 +79,53 @@ The errors below are general to the copy activity and could occur with any conne
 
     3. Save the file, and then restart the Self-hosted IR machine.
 
-### Error code: JniException
+#### Error code: JniException
 
 - **Message**: `An error occurred when invoking Java Native Interface.`
 
 - **Cause**: If the error message contains "Cannot create JVM: JNI return code [-6][JNI call failed: Invalid arguments.]", the possible cause is that JVM can't be created because some illegal (global) arguments are set.
 
 - **Recommendation**: Log in to the machine that hosts *each node* of your self-hosted integration runtime. Check to ensure that the system variable is set correctly, as follows: `_JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G`. Restart all the integration runtime nodes, and then rerun the pipeline.
 
-### Error code: GetOAuth2AccessTokenErrorResponse
+#### Error code: GetOAuth2AccessTokenErrorResponse
 
 - **Message**: `Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.`
 
 - **Cause**: Your client ID or client secret is invalid, and the authentication failed in your authorization server.
 
 - **Recommendation**: Correct all OAuth2 client credential flow settings of your authorization server.
 
-### Error code: FailedToGetOAuth2AccessToken
+#### Error code: FailedToGetOAuth2AccessToken
 
 - **Message**: `Failed to get access token from your token endpoint. Error message: %errorMessage;.`
 
 - **Cause**: OAuth2 client credential flow settings are invalid.
 
 - **Recommendation**: Correct all OAuth2 client credential flow settings of your authorization server.
 
-### Error code: OAuth2AccessTokenTypeNotSupported
+#### Error code: OAuth2AccessTokenTypeNotSupported
 
 - **Message**: `The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.`
 
 - **Cause**: Your authorization server is not supported.
 
 - **Recommendation**: Use an authorization server that can return tokens with supported token types.
 
-### Error code: OAuth2ClientIdColonNotAllowed
+#### Error code: OAuth2ClientIdColonNotAllowed
 
 - **Message**: `The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.`
 
 - **Cause**: Your client ID includes the invalid character colon (`:`).
 
 - **Recommendation**: Use a valid client ID.
 
-### Error code: ManagedIdentityCredentialObjectNotSupported
+#### Error code: ManagedIdentityCredentialObjectNotSupported
 
 - **Message**: `Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.`
 
 - **Recommendation**: Check the supported version and upgrade the integration runtime to a higher version.
 
-### Error code: QueryMissingFormatSettingsInDataset
+#### Error code: QueryMissingFormatSettingsInDataset
 
 - **Message**: `The format settings are missing in dataset %dataSetName;.`
 
@@ -137,99 +137,99 @@ The errors below are general to the copy activity and could occur with any conne
 
 - **Recommendation**: Deselect the "Binary copy" in the dataset, and set correct format settings.
 
-### Error code: QueryUnsupportedCommandBehavior
+#### Error code: QueryUnsupportedCommandBehavior
 
 - **Message**: `The command behavior "%behavior;" is not supported.`
 
 - **Recommendation**: Don't add the command behavior as a parameter for preview or GetSchema API request URL.
 
-### Error code: DataConsistencyFailedToGetSourceFileMetadata
+#### Error code: DataConsistencyFailedToGetSourceFileMetadata
 
 - **Message**: `Failed to retrieve source file ('%name;') metadata to validate data consistency.`
 
 - **Cause**: There is a transient issue on the sink data store, or retrieving metadata from the sink data store is not allowed.
 
-### Error code: DataConsistencyFailedToGetSinkFileMetadata
+#### Error code: DataConsistencyFailedToGetSinkFileMetadata
 
 - **Message**: `Failed to retrieve sink file ('%name;') metadata to validate data consistency.`
 
 - **Cause**: There is a transient issue on the sink data store, or retrieving metadata from the sink data store is not allowed.
 
-### Error code: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
+#### Error code: DataConsistencyValidationNotSupportedForNonDirectBinaryCopy
 
 - **Message**: `Data consistency validation is not supported in current copy activity settings.`
 
 - **Cause**: The data consistency validation is only supported in the direct binary copy scenario.
 
 - **Recommendation**: Remove the 'validateDataConsistency' property in the copy activity payload.
 
-### Error code: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
+#### Error code: DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime
 
 - **Message**: `'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.`
 
 - **Recommendation**: Check the supported integration runtime version and upgrade it to a higher version, or remove the 'validateDataConsistency' property from copy activities.
 
-### Error code: SkipMissingFileNotSupportedForNonDirectBinaryCopy
+#### Error code: SkipMissingFileNotSupportedForNonDirectBinaryCopy
 
 - **Message**: `Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.`
 
 - **Recommendation**: Remove 'fileMissing' of the skipErrorFile setting in the copy activity payload.
 
-### Error code: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
+#### Error code: SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy
 
 - **Message**: `Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.`
 
 - **Recommendation**: Remove 'dataInconsistency' of the skipErrorFile setting in the copy activity payload.
 
-### Error code: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
+#### Error code: SkipForbiddenFileNotSupportedForNonDirectBinaryCopy
 
 - **Message**: `Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.`
 
 - **Recommendation**: Remove 'fileForbidden' of the skipErrorFile setting in the copy activity payload.
 
-### Error code: SkipForbiddenFileNotSupportedForThisConnector
+#### Error code: SkipForbiddenFileNotSupportedForThisConnector
 
 - **Message**: `Skip forbidden file is not supported for this connector: ('%connectorName;').`
 
 - **Recommendation**: Remove 'fileForbidden' of the skipErrorFile setting in the copy activity payload.
 
-### Error code: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
+#### Error code: SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy
 
 - **Message**: `Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.`
 
 - **Recommendation**: Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
 
-### Error code: SkipInvalidFileNameNotSupportedForSource
+#### Error code: SkipInvalidFileNameNotSupportedForSource
 
 - **Message**: `Skip invalid file name is not supported for '%connectorName;' source.`
 
 - **Recommendation**: Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
 
-### Error code: SkipInvalidFileNameNotSupportedForSink
+#### Error code: SkipInvalidFileNameNotSupportedForSink
 
 - **Message**: `Skip invalid file name is not supported for '%connectorName;' sink.`
 
 - **Recommendation**: Remove 'invalidFileName' of the skipErrorFile setting in the copy activity payload.
 
-### Error code: SkipAllErrorFileNotSupportedForNonBinaryCopy
+#### Error code: SkipAllErrorFileNotSupportedForNonBinaryCopy
 
 - **Message**: `Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.`
 
 - **Recommendation**: Remove 'allErrorFile' in the skipErrorFile setting in the copy activity payload.
 
-### Error code: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
+#### Error code: DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy
 
 - **Message**: `'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.`
 
 - **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting or use direct binary copy.
 
-### Error code: DeleteFilesAfterCompletionNotSupportedForThisConnector
+#### Error code: DeleteFilesAfterCompletionNotSupportedForThisConnector
 
 - **Message**: `'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').`
 
 - **Recommendation**: Remove the 'deleteFilesAfterCompletion' setting in the copy activity payload.
 
-### Error code: FailedToDownloadCustomPlugins
+#### Error code: FailedToDownloadCustomPlugins
 
 - **Message**: `Failed to download custom plugins.`
 
@@ -239,15 +239,15 @@ The errors below are general to the copy activity and could occur with any conne
 
 ## General connector errors
 
-### Error code: UserErrorOdbcInvalidQueryString
+#### Error code: UserErrorOdbcInvalidQueryString
 
 - **Message**: `The following ODBC Query is not valid: '%'.`
 
 - **Cause**: You provide a wrong or invalid query to fetch the data/schemas.
 
 - **Recommendation**: Verify your query is valid and can return data/schemas. Use [Script activity](transform-data-using-script.md) if you want to execute non-query scripts and your data store is supported. Alternatively, consider to use stored procedure that returns a dummy result to execute your non-query scripts.
 
-### Error code: FailToResolveParametersInExploratoryController 
+#### Error code: FailToResolveParametersInExploratoryController 
 
 - **Message**: `The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.`