Deprecate ScalarUDFImpl::invoke_batch and move everything to ScalarUDFImpl::invoke_with_args

[alamb]

Is your feature request related to a problem or challenge?

The current state of the invoke signature for ScalarUDFImpl is somewhat confusing. After

• Add ScalarUDFImpl::invoke_with_args to support passing the return type created for the udf instance #13290

We will have 4 functions

• ScalarUDFImpl::invoke (deprecated, only args)
• ScalarUDFImpl::invoke_no_args (deprecated, only row counts)
• ScalarUDFImpl::invoke_batch (has row counts and args)
• ScalarUDFImpl::invoke_with_args (added to support Access children DataType or return-type in ScalarUDFImpl::invoke #12819, has a structure that has arguments, row counts, and return types)

Ideally, we probably should not have added invoke_batch but unfortunately we released it in

• Release DataFusion 43.0.0 #12470

With a deprecation message telling users to migrate from invoke / invoke_no_args to invoke_batch

Ideally we want to move everyone to invoke_with_args, but if we did so at this time, it would force downstream crates to migrate twice in quick succession, which is non ideal.

Describe the solution you'd like

Rather than immediately deprecate invoke_batch and force another confusing upgrade, I propose we leave invoke_batch and invoke_with_args for several releases to allow downstream crates to update.

Describe alternatives you've considered

Then in a few months (maybe DataFusion 46, or 47) we can deprecate invoke_batch and move everything to invoke_with_args

Additional context

No response

[findepi]

I removed "eventually" from the issue title. The API cleanup is due.