Update Doc string for SnowflakeOperatorAsync

[bharanidharan14]

Added Doc string for the SnowflakeOperatorAsync to get to know the use of this operator compared with snowflake sql API operator, best practices to be followed while using this operator and where can this SnowflakeOperatorAsync can be used

closes: #557

[codecov]

Codecov Report

Merging #556 (d477832) into main (46a607f) will not change coverage.
The diff coverage is n/a.

❗ Current head d477832 differs from pull request most recent head b389902. Consider uploading reports for the commit b389902 to get more accurate results

@@           Coverage Diff           @@
##             main     #556   +/-   ##
=======================================
  Coverage   98.27%   98.27%           
=======================================
  Files          72       72           
  Lines        3996     3996           
=======================================
  Hits         3927     3927           
  Misses         69       69           

Impacted Files	Coverage Δ
...ronomer/providers/snowflake/operators/snowflake.py	100.00% <ø> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 46a607f...b389902. Read the comment docs.

[bharanidharan14]

@phanikumv @rajaths010494 @pankajastro @pankajkoti, can you review this PR

[pankajastro]

@phanikumv @rajaths010494 @pankajastro @pankajkoti, can you review this PR

Can you please post the screenshot like how it is looking you can run make docs?

[rajaths010494]

LGTM , once Screenshot is added we can close.

[bharanidharan14]

@rajaths010494 @pankajastro Added screenshot

[pankajastro]

@rajaths010494 @pankajastro Added screenshot

I can't see the below text in the screenshot but it is in the doc string. I was curious to see how it looks otherwise changes look good to me

for the query status based on the query id from different connection.
.. see also::
https://docs.snowflake.com/en/user-guide/python-connector-example.html#label-python-connector-querying-data-asynchronous.

[bharanidharan14]

@rajaths010494 @pankajastro Added screenshot

I can't see the below text in the screenshot but it is in the doc string. I was curious to see how it looks otherwise changes look good to me

for the query status based on the query id from different connection.
.. see also::
https://docs.snowflake.com/en/user-guide/python-connector-example.html#label-python-connector-querying-data-asynchronous.

See also link is not visible in Docs, its not showing up in any of the operators/sensors

[pankajastro]

@rajaths010494 @pankajastro Added screenshot

I can't see the below text in the screenshot but it is in the doc string. I was curious to see how it looks otherwise changes look good to me

for the query status based on the query id from different connection.
.. see also::
https://docs.snowflake.com/en/user-guide/python-connector-example.html#label-python-connector-querying-data-asynchronous.

See also link is not visible in Docs, its not showing up in any of the operators/sensors

then this is a bug in our documentation please create a ticket to track it. But I was able to do it in #464

[bharanidharan14]

@rajaths010494 @pankajastro Added screenshot

I can't see the below text in the screenshot but it is in the doc string. I was curious to see how it looks otherwise changes look good to me

for the query status based on the query id from different connection.
.. see also::
https://docs.snowflake.com/en/user-guide/python-connector-example.html#label-python-connector-querying-data-asynchronous.

See also link is not visible in Docs, its not showing up in any of the operators/sensors

then this is a bug in our documentation please create a ticket to track it. But I was able to do it in #464

Created Ticket

[bharanidharan14]

@phanikumv Addressed your PR review changes

[pankajkoti]

LGTM, minor suggestions.

[bharanidharan14]

@phanikumv Addressed your review comments, can you please review it again

[bharanidharan14]

@phanikumv Need your approval